(navigation image)
Home American Libraries | Canadian Libraries | Universal Library | Community Texts | Project Gutenberg | Children's Library | Biodiversity Heritage Library | Additional Collections
Search: Advanced Search
Anonymous User (login or join us)
Upload
See other formats

Full text of "ibm :: 370 :: OS VS1 :: GC24-5091-3 OS VS1 Rel 3 Programmers Reference Digest Dec73"

GC24-5091-3 
File No. S370-36 



OS/VS1 Programmer's 
Systems Reference Digest 



VS1 Release 3 



m 



PREFACE 



This publication contains quick reference information for the experienced 
programmer and systems support personnel. For the most part, definitions, 
restrictions, and limitations have been omitted to provide the most rapid 
access to the information in this publication. If the reference to information 
included here is not sufficient, refer to the publication list on the first page 
of each section; then refer to the applicable System Reference Library 
publication. 

This publication, the OS/VS2 TSO Command Language Reference Summary, 
GX28-0647, and the OS/ VS Service Aids Reference Summary, GX28-0634, 
may be ordered by specifying OS/ VS Reference Digest Package, BOF-3200, 
rather than individual order numbers. 

This publication does not contain information about system control blocks. 
Refer to OS/VS1 System Data Areas, SY28-0605, to find this information. 
Some information useful in debugging the system is contained in this 
publication. For additional information, refer to OS/VS1 Debugging Guide, 
GC28-6670. 



Fourth Edition (December 1973) 

This edition applies to Release 3 of OS/VS1 and to all subsequent releases until other- 
wise indicated in new editions or Technical Newsletters. Changes are continually made 
to the information contained herein; before using this publication in connection with 
the operation of IBM systems, consult the IBM System/360 and System/370 Bibliography, 
GA22-6822, for the editions that are applicable and current. 

A handbook-sized binder, FE part number 453559, may be purchased from IBM. 
Customers may order it through their IBM marketing representative. IBM personnel 
should order it as an FE part from Mechanicsburg. 

This edition is a major revision of, and obsoletes the OS/VS1 information found in 
GC24-5091-2. Changes or additions to the text and illustrations are indicated by a 
vertical line to the left of the change. 

Requests for copies of IBM publications should be made to your IBM representative 
or to the IBM branch office serving your locality. 

A form for reader's comments is provided at the back of this publication. If the form 
has been removed, comments may be addressed to IBM Programming Publications, 
Dept. G60, P.O. Box 6, Endicott, New York 13760. Comments become the property 
of IBM 



> Copyright International Business Machines Corporation 1973 



Summary of Amendments 

for GC24-5091-3 

VS1 Release 3 



0S/VS2 information is removed from this publication, which now supports 
OS/VS1 only. 

SECTIONS 1,2,3, and 4 contain information included for the first time. 
This material includes: 

SECTION 1 

machine-check interruption code 

I/O command codes 

ANSI control characters 

dynamic address translation information 

SECTION 2 

trace table information 

system register usage 

device information 

wait state codes 

ENQ/DEQ names 

"how to find" information 

SECTION 3 

SVC to module directory 
supervisor flow of control diagrams 

SECTION 4 

data set record formats 

VSAM macros for data access 

access method flow of control diagrams 

All sections contain substantial changes to previous content. Review them in 
their entirety for new and modified information. 



Summary of Amendments 



Summary of Amendments 
forGC24-5091-2 
0S/VS1 Release 2 
0S/VS2 Release 1 



SECTIONS 1,3,5, 7, 8, or 9 REFLECT ADDED: 

• Base Publications Supporting OS/ VS1 and OS/VS2 

• Code Translation Tables 

• General Services Macros 

• JCL Statements 

• Load Module Control Macros 

• Program Interruption Control Macros 

• RES Operator Commands 

• RES Workstation Commands 

• Synchronization Macros 

• Task Control Macros 

• TCAM Macros 

• Termination Macros 

• Utility Programs 

• Virtual Storage Macros 

• VS1 Operator Commands 

• VS2 Operator Commands 

SECTIONS 2, 3, 4, or 7 REFLECT UPDATED: 

• Data Management Macros 

• OS/VS1 Completion Code Summary 

• OS/VS2 Completion Code Summary 

• Programming Conventions for SVC Routines 

• Summary of Supervisor Operands 

• Supervisor Macro Outlines 

• SVC Summary for OS/ VS1 

• SVC Summary for OS/VS2 

• TCAM Devices Supported 

• TCAM Macro Operands 

• UCB Sense Information 



OS/VS1 Programmer's Reference Digest 



CONTENTS 



Section 1: General Information 

Section 2: System Information 

Section 3: Supervisor Information 

Section 4: Data Management Information 

Section 5: JCL, Operator Commands, RES, SMF, and CRJE 

Section 6: Linkage Editor and Loader 

Section 7: BTAM/TCAM 

Section 8: Utilities 

Section 9: Bibliography 

Index 



Contents 



0S/VS1 Programmer's Reference Digest 



Section 1: General Information 



Code Translation Table 1-2 

Machine Instruction Formats 1-6 

Control Registers 1-7 

Condition Codes 1-8 

Program Interruption Codes and CNOP Alignment 1-9 

Fixed Storage Locations 1-10 

PS W Formats 1-11 

CAW, CCW, and CSW Formats 1-12 

Limited Channel Logout and Machine-check Interruption Code 1-13 

I/O Command Codes 1-14 

System/370 Instructions 1-17 

System Assembler Instructions, Statements, and Constants 1-50 

Dynamic Address Translation and Hexadecimal and Decimal 

Conversion Information 1-60 
EBCDIC Codes 1-67 



Source Publications 



Additional information about the System/370 and valid instructions 
is contained in IBM System/ 370 Principles of Operation, GA22-7000. 

Additional information about the System Assembler is in OS/VS 
and DOS/VS Assembler Language, GC33-40 1 0. 



Section 1: General Information 1-1 



Code Translation Table 







Instruction 


Graphics and Controls 


7-Track Tape 






Dec. 


Hex 


(RR) 


BCDIC EBCDIC(l) 


ASCII 


BCDICI2) 


Card Code 


Binary 





00 




NUL 


NUL 




12-0-1-8-9 


0000 0000 


1 


01 




SOH 


SOH 




12-1-9 


0000 0001 


2 


02 




STX 


STX 




12-2-9 


0000 0010 


3 


03 




ETX 


ETX 




12-3-9 


0000 0011 


4 


04 


SPM 


PF 


EOT 




12-4-9 


0000 0100 


5 


05 


BALR 


HT 


ENQ 




12-5-9 


0000 0101 


6 


06 


BCTR 


LC 


ACK 




12-6-9 


0000 0110 


7 


07 


BCR 


DEL 


BEL 




12-7-9 


0000 0111 


8 


08 


SSK 




BS 




12-8-9 


0000 1000 


9 


09 


ISK 




HT 




12-1-8-9 


0000 1001 


10 


0A 


SVC 


SMM 


LF 




12-2-8-9 


0000 1010 


11 


OB 




VT 


VT 




12-3-8-9 


0000 1011 


12 


OC 




FF 


FF 




12-4-8-9 


0000 1100 


13 


OD 




CR 


CR 




12-5-8-9 


0000 1101 


14 


OE 


MVCL 


SO 


SO 




12-6-8-9 


0000 1110 


15 


OF 


CLCL 


SI 


SI 




12-7-8-9 


0000 1111 


16 


10 


LPR 


DLE 


DLE 




12-11-1-8-9 


00010000 


17 


11 


LNR 


DC1 


DC1 




11-1-9 


00010001 


18 


12 


LTR 


DC2 


DC2 




11-2-9 


00010010 


19 


13 


LCR 


TM 


DC3 




11-3-9 


00010011 


20 


14 


NR 


RES 


DC4 




11-4-9 


00010100 


21 


15 


CLR 


NL 


NAK 




11-5-9 


0001 0101 


22 


16 


OR 


BS 


SYN 




11-6-9 


0001 0110 


23 


17 


XR 


IL 


ETB 




11-7-9 


00010111 


24 


18 


LR 


CAN 


CAN 




11-8-9 


00011000 


25 


19 


CR 


EM 


EM 




11-1-8-9 


00011001 


26 


1A 


AR 


CC 


SUB 




11-2-8-9 


0001 1010 


27 


IB 


SR 


CU1 


ESC 




11-3-8-9 


0001 1011 


28 


1C 


MR 


IFS 


FS 




11-4-8-9 


00011100 


29 


ID 


DR 


IGS 


GS 




11-5-8-9 


0001 1101 


30 


IE 


ALR 


IRS 


RS 




11-6-8-9 


0001 1110 


31 


IF 


SLR 


IUS 


US 




11-7-8-9 


oooi mi 


32 


20 


LPDR 


DS 


SP 




11-0-1-8-9 


0010 0000 


33 


21 


LNDR 


SOS 


i ! 




0-1-9 


0010 0001 


34 


22 


LTDR 


FS 


" 




0-2-9 


0010 0010 


35 


23 


LCDR 




# 




0-3-9 


0010 0011 


36 


24 


HDR 


BYP 


$ 




0-4-9 


0010 0100 


37 


25 


LRDR 


LF 


% 




0-5-9 


0010 0101 


38 


26 


MXR 


ETB 


& 




0-6-9 


0010 0110 


39 


27 


MXDR 


ESC 


' 




0-7-9 


0010 0111 


40 


28 


LDR 




( 




0-8-9 


0010 1000 


41 


29 


CDR 




) 




0-1-8-9 


0010 1001 


42 


2A 


ADR 


SM 


• 




0-2-8-9 


0010 1010 


43 


2B 


SDR 


CU2 


+ 




0-3-8-9 


0010 1011 


44 


2C 


MDR 








0-4-8-9 


0010 1100 


45 


2D 


DDR 


ENQ 


- 




0-5-8-9 


0010 1101 


46 


2E 


AWR 


ACK 






0-6-8-9 


0010 1110 


47 


2F 


SWR 


BEL 


/ 




0-7-8-9 


ooio mi 


48 


30 


LPER 









12-11-0-1-8-9 


00110000 


49 


31 


LNER 




1 




1-9 


00110001 


50 


32 


LTER 


SYN 


2 




2-9 


00110010 


51 


33 


LCER 




3 




3-9 


00110011 


52 


34 


HER 


PN 


4 




4-9 


00110100 


53 


35 


LRER 


RS 


5 




5-9 


00110101 


54 


36 


AXR 


UC 


6 




6-9 


00110110 


55 


37 


SXR 


EOT 


7 




7-9 


00110111 


56 


38 


LER 




8 




8-9 


00111000 


57 


39 


CER 




9 




1-8-9 


0011 1001 


58 


3A 


AER 








2-8-9 


0011 1010 


59 


3B 


SER 


CU3 






3-8^ 


0011 1011 


60 


3C 


MER 


DC4 


< 




4-8-9 


0011 1100 


61 


3D 


DER 


NAK 


• 




5-8-9 


0011 1101 


62 


3E 


AUR 




> 




6-8^ 


0011 1110 


63 


3F 


SUR 


SUB 


? 




7-8-9 


ooii mi 



1 -2 OS/VS1 Programmer's Reference Digest 



Code Translation Table (cont'd) 







Instruction 


Graphics and Controls 


7-Track Tape 






Dec. 


Hex 


(RX) 


BCDIC EBCDIC(l) ASCII 


BCDIC(2) 


Card Code 


Binary 


64 


40 


STH 


Sp Sp @ 


(3) 


no punches 


0100 0000 


65 


41 


LA 


A 




12-0-1-9 


0100 0001 


66 


42 


STC 


B 




12-0-2-9 


0100 0010 


67 


43 


IC 


C 




12-0-3-9 


0100 0011 


68 


44 


EX 


D 




12-0-4-9 


0100 0100 


69 


45 


BAL 


E 




12-0-5-9 


0100 0101 


70 


46 


BCT 


F 




12-0-6-9 


0100 0110 


71 


47 


BC 


G 




12-0-7-9 


0100 0111 


72 


48 


LH 


H 




12-0-8-9 


0100 1000 


73 


49 


CH 


1 




12-1-8 


0100 1001 


74 


4A 


AH 


t * J 




12-2-8 


0100 1010 


75 


4B 


SH 


. . K 


BA8 21 


12-3-8 


0100 1011 


76 


4C 


MH 


a ) < < L 


BA84 


12-4-8 


0100 1100 


77 


4D 




[ ( ( M 


BA84 1 


12-5-8 


0100 1101 


78 


4E 


CVD 


< + + N 


BA842 


12-6-8 


0100 1110 


79 


4F 


CVB 


* I I 


BA8421 


12-7-8 


oioo mi 


80 


50 


ST 


& + & & P 


BA 


12 


01010000 


81 


51 




Q 




12-11-1-9 


01010001 


82 


52 




R 




12-11-2-9 


0101 0010 


83 


53 




S 




12-11-3-9 


01010011 


84 


54 


N 


T 




12-11-4-9 


0101 0100 


85 


55 


CL 


U 




12-11-5-9 


01010101 


86 


56 





V 




12-11-6-9 


01010110 


87 


57 


X 


w 




12-11-7-9 


01010111 


88 


58 


L 


X 




12-11-8-9 


0101 1000 


89 


59 


C 


Y 




11-1-8 


0101 1001 


90 


5A 


A 


! ! Z 




11-2-8 


0101 1010 


91 


5B 


S 


$ $ $ [ 


B 8 21 


11-3-8 


0101 1011 


92 


5C 


M 


• • \ 


B 84 


11-4-8 


0101 1100 


93 


5D 


D 


] ) ) ] 


B 84 1 


11-5-8 


0101 1101 


94 


5E 


AL 


; ; ; ~~ ' ~ 


B 842 


11-6-8 


0101 1110 


95 


5F 


SL 


A — i — i _ 


B 8421 


11-7-8 


oioi mi 


96 


60 


STD 


- 


B 


11 


0110 0000 


97 


61 




/ / / a 


A 1 


0-1 


0110 0001 


98 


62 




b 




11-0-2-9 


0110 0010 


99 


63 




c 




11-0-3-9 


0110 0011 


100 


64 




d 




11-0-4-9 


0110 0100 


101 


65 




e 




11-0-5-9 


0110 0101 


102 


66 




f 




11-0-6-9 


0110 0110 


103 


67 


MXD 


q 




11-0-7-9 


0110 0111 


104 


68 


LD 


h 




11-0-8-9 


0110 1000 


105 


69 


CD 


i 




0-1-8 


0110 1001 


106 


6A 


AD 


! j 




12-11 


0110 1010 


107 


6B 


SD 


, . k 


A8 21 


0-3-8 


0110 1011 


108 


6C 


MD 


%( % % 1 


A84 


0-4-8 


0110 1100 


109 


6D 


DD 


Y _ _ m 


A84 1 


0-5-8 


0110 1101 


110 


6E 


AW 


\ > > n 


A842 


0-6-8 


0110 1110 


111 


6F 


SW 


? ? 


A8421 


0-7-8 


ono mi 


112 


70 


STE 


P 




12-11-0 


01110000 


113 


71 




q 




12-11-0-H 


01110001 


114 


72 




r 




12-11-0-2-9 


0111 0010 


115 


73 




s 




12-11-0-3-9 


01110011 


116 


74 




t 




12-11-0-4-9 


01110100 


117 


75 




u 




12-11-0-5-9 


01110101 


118 


76 




V 




12-11-0-6-9 


01110110 


119 


77 




w 




12-11-0-7-9 


01110111 


120 


78 


LE 


X 




12-11-0-8-9 


0111 1000 


121 


79 


CE 


y 




1-8 


0111 1001 


122 


7A 


AE 


t : : Z 


A 


2-8 


0111 1010 


123 


7B 


SE 


#« # # { 


8 21 


3-8 


0111 1011 


124 


7C 


ME 


@* @ @ ! 


84 


4-8 


0111 1100 


125 


7D 


DE 


: ' ' } 


84 1 


5-8 


0111 1101 


126 


7E 


AU 


> . 


842 


6-8 


0111 1110 


127 


7F 


SU 


S " " DEL 


8421 


7-8 


01111111 



Section 1: General Information 1-3 



Code Translation Table (cont'd) 



Dec. 


Hex 


Instruction 
and Format 


Graphics and Controls 
BCDIC EBCDIC(l) ASCII 


7-Track Tape 
BCDIC(2) 


Card Code 


Binary 


128 
129 
130 
131 


80 
81 
82 
83 


SSM -S 

LPSW -S 
Diagnose 


a a 
b b 
c c 




12-0-1-8 
12-0-1 
12-0-2 
12-0-3 


1000 0000 
1000 0001 
1000 0010 
1000 0011 


132 
133 
134 
135 


84 
85 
86 
87 


WRD 
RDD 
BXH 
BXLE 


SI 


d d 
e e 
f f 
q g 




12-0-4 
12-0-5 
12-0-6 
12-0-7 


1000 0100 
1000 0101 
1000 0110 
1000 0111 


136 
137 
138 
139 


88 
89 
8A 
8B 


SRL 
SLL 
SRA 
SLA 


RS 


h h 
i f 

{ 




12-0-8 
12-0-9 
12-0-2-8 
12-0-3-8 


10001000 
10001001 
1000 1010 
1000 1011 


140 
141 
142 
143 


8C 
8D 
8E 

8F 


SRDL 
SLDL 
SRDA 
SLDA 




+ 




12-0-4-8 
12-0-5-8 
12-0-6-8 
12-0-7-8 


1000 1100 
1000 1101 
1000 1110 

iooo mi 


144 
145 
146 
147 


90 
91 
92 
93 


STM 
TM 
MVI 
TS 


SI 
-S 


J J 
k k 
1 1 




12-11-1-8 
12-11-1 
12-11-2 
12-11-3 


10010000 
10010001 

1001 0010 

1001 0011 


148 
149 
150 
151 


94 
95 
96 
97 


Nl 
CLI 
01 
XI 


SI 


m m 
n n 


D P 




12-11-4 
12-11-5 
12-11-6 
12-11-7 


1001 0100 

1001 0101 
1001 0110 
1001 0111 


152 
153 
154 
155 


98 
99 
9A 
9B 


LM -RS 


q q 

r r 

} 




12-11-8 
12-11-9 
12-11-2-8 
12-11-3-8 


10011000 
1001 1001 

1001 1010 

1001 1011 


156 
157 
158 
159 


9C 
9D 
9E 
9F 


SIO.SIOF 
TIO.CLRIO 
HIO.HDV 
TCH 


n 

■ 




12-11-4-8 
12-11-5-8 
12-11-6-8 
12-11-7-8 


1001 1100 
1001 1101 
1001 1110 
1001 llli 


160 
161 
162 
163 


A0 
Al 
A2 
A3 




s s 
t t 




11-0-1-8 
11-0-1 
11-0-2 
11-0-3 


1010 0000 
1010 0001 
1010 0010 
1010 0011 


164 
165 
166 
167 


A4 
A5 
A6 
A7 




u u 

V V 

w w 

X X 




1HM 
11-0-5 
11-0-6 
11-0-7 


1010 0100 
1010 0101 
1010 0110 
1010 0111 


168 
169 
170 
171 


A8 
A9 
AA 
AB 




y y 

z z 




11-0-8 
11-0-9 
11-0-2-8 
11-0-3-8 


1010 1000 
1010 1001 
1010 1010 
1010 1011 


172 
173 
174 
175 


AC 
AD 
AE 
AF 


STNSMU, 
STOSMJ 
SIGP -RS 
MC -SI 


[ 

> 
• 




11-0-4-8 
11-0-5-8 
11-0-6-8 
11-0-7-8 


1010 1100 
1010 1101 
1010 1110 
1010 1111 


176 
177 
178 
179 


BO 
Bl 
B2 
B3 


LRA -RX 
See below 




1 

2 
3 




12-11-0-1-8 
12-11-0-1 
12-11-0-2 
12-11-0-3 


10110000 
1011 0001 
1011 0010 
10110011 


180 
181 
182 
183 


B4 
B5 
B6 
B7 


STCTL | RS 
LCTL f RS 


4 

s 

6 

7 




12-11-0-4 
12-11-0-5 
12-11-0-6 
12-11-0-7 


1011 0100 

1011 0101 
1011 0110 
10110111 


184 
185 
186 
187 


B8 
B9 
BA 
BB 


CDS | RS 


8 
9 




12-11-0-8 
12-11-0-9 
12-11-0-2-8 
12-11-0-3-8 


1011 1000 

1011 1001 
101M010 
1011 1011 


188 
189 
190 
191 


BC 
BD 
BE 
BF 


CLM 1 
STCM RS 
ICM J 


] 

■f 




12-11-0-4-8 
12-11-0-5-8 
12-11-0-6-8 
12-11-0-7-8 


1011 1100 

1011 1101 
1011 1110 
1011 1111 



1 -4 OS/VS1 Programmer's Reference Digest 



Code Translation Table (cont'd) 







Instruction 


Graphics 


and Controls 


7-Track Tape 






Dec. 


Hex 


ISS) 


BCDIC 


EBCDICU) ASCII 


BCDIC(2) 


Card Code 


Binary 


192 


CO 




? 


{ 




BA8 2 


12-0 


1100 0000 


193 


CI 




A 


A 


A 


BA 1 


12-1 


1100 0001 


194 


C2 




B 


B 


B 


BA 2 


12-2 


1100 0010 


195 


C3 




C 


C 


C 


BA 21 


12-3 


1100 0011 


196 


C4 




D 


D 


D 


BA 4 


12-4 


1100 0100 


197 


C5 




E 




E 


BA 4 1 


12-5 


1100 0101 


198 


C6 




F 




F 


BA 42 


12-6 


1100 0110 


199 


C7 




G 




G 


BA 421 


12-7 


1100 0111 


200 


C8 




H 




H 


BA8 


12-3 


1100 1000 


201 


C9 




I 




1 


BA8 1 


12-9 


1100 1001 


202 


CA 












12-0-2-8-9 


1100 1010 


203 


CB 












12-0-3-8-9 


1100 1011 


204 


CC 












12-0-4-8-9 


1100 1100 


205 


CD 












12-0-5-8-9 


1100 1101 


206 


CE 












12-0-6-8-9 


1100 1110 


207 


CF 












12-0-7-8-9 


noo mi 


208 


DO 




! 






B 8 2 


11-0 


11010000 


209 


Dl 


MVN 


J 




J 


B 1 


11-1 


11010001 


210 


D2 


MVC 


K 




K 


B 2 


11-2 


1101 0010 


211 


03 


MVZ 


L 




L 


B 21 


11-3 


11010011 


212 


D4 


NC 


M 


M 


M 


B 4 


11-4 


11010100 


213 


D5 


CLC 


N 


N 


N 


B 4 1 


11-5 


1101 0101 


214 


D6 


OC 











B 42 


11-6 


11010110 


215 


D7 


XC 


P 


P 


P 


B 421 


11-7 


1101 0111 


216 


D8 




Q 


Q 


Q 


B 8 


11-8 


1101 1000 


217 


D9 




R 


R 


R 


B 8 1 


11-9 


1101 1001 


218 


DA 












12-11-2-8-9 


1101 1010 


219 


DB 












12-11-3-8-9 


1101 1011 


220 


DC 


TR 










12-11-4-8-9 


1101 1100 


221 


DD 


TRT 










12-11-5-8-9 


1101 1101 


222 


DE 


ED 










12-11-6-8-9 


1101 1110 


223 


DF 


EDMK 










12-11-7-8-9 


noi mi 


224 


EO 




t 


\ 




A3 2 


0-2-8 


1110 0000 


225 


El 












11-0-1-9 


1110 0001 


226 


E2 




S 


S 


S 


A 2 


0-2 


1110 0010 


227 


E3 




T 


T 


T 


A 21 


0-3 


1110 0011 


228 


E4 




U 


U 


U 


A 4 


0-4 


1110 0100 


229 


E5 




V 


V 


V 


A 4 1 


0-5 


1110 0101 


230 


E6 




W 


w 


W 


A 42 


0-« 


1110 0110 


231 


E7 




X 


X 


X 


A 421 


0-7 


1110 0111 


232 


E8 




Y 


Y 


Y 


A8 


0-8 


1110 1000 


233 


E9 




Z 


z 


Z 


A8 1 


0-9 


1110 1001 


234 


EA 












11-0-2-8-9 


1110 1010 


235 


EB 












11-0-3-8-9 


1110 1011 


236 


EC 






H 






11-0-4-8-9 


1110 1100 


237 


ED 












11-0-5-8-9 


1110 1101 


238 


EE 












11-0-6-8-9 


1110 1110 


239 


EF 












11-0-7-3-9 


mo mi 


240 


FO 


SRP 











8 2 





11110000 


241 


Fl 


MVO 


1 


1 


1 


1 


1 


11110001 


242 


F2 


PACK 


2 


2 


2 


2 


2 


11110010 


243 


F3 


UNPK 


3 


3 


3 


21 


3 


11110011 


244 


F4 




4 


4 


4 


4 


4 


11110100 


245 


F5 




5 


5 


5 


4 1 


5 


11110101 


246 


F6 




6 


6 


6 


42 


6 


11110110 


247 


F7 




7 


7 


7 


421 


7 


nn oni 


248 


F8 


ZAP 


8 


8 


8 


8 


8 


mi iooo 


249 


F9 


CP 


9 


9 


9 


8 1 


9 


nn iooi 


250 


FA 


AP 




1 






12-11-0-2-8-9 


nn ioio 


251 


FB 


SP 










12-11-0-3-8-9 


nn ion 



Section 1: General Information 1-5 



Code Translation Table (cont'd) - Machine Instruction Formats 



Dec. 


Hex 


Instruction 
(SS) 


Graphics and Controls 
BCDIC EBCDICU) ASCII 


7-Track Tape 
BCDIC(2) 


Card Code 


Binary 


252 
253 
254 
255 


FC 
FD 
FE 
FF 


MP 
DP 






12-11-0-4-8-9 
12-11-0-5-8-9 
12-11-0-6-8-9 
12-11-0-7-8-9 


1111 1100 
1111 1101 
1111 1110 
1111 1111 



1. Two columns of EBCDIC graphics 
are shown. The first gives standard 
bit pattern assignments. The second 
shows the T-ll and TN text printing 



chains (120 graphics). 

2. Add C (check bit) for odd or even 
parity as needed, except as noted. 

3. For even parity use CA. 



Op cod 


; (S forma 


) 








B202 


-STIDP 


B207 


STCKC 


B20D 


-PTLB 


B203 


-STIDC 


B208 


SPT 


B210 


SPX 


B204 


-SCK 


B209. 


STPT 


B211 


STPX 


B205 


-STCK 


B20A 


-SPKA 


B212- 


STAP 


B206 


■SCKC 


B20B 


-IPK 


B213- 


RRB 



Machine Instruction Formats 



FIRST HALFWORD 1 SECOND HALFWORD 2 THIRD HALFWORD 3 



R1 J R2 I 



I 

I 


REGISTER I ADDRESS OF 
OPERANDI | OPERAND 2 


1 
1 


I OpCode | R1 | X2 | B2 | D2 | 


O 

I 
I 


7 

REGIS 
OPER/ 


8 1112 1516 1920 

TER REGISTER ADDRESS OF 
\ND 1 OPERAND 3 OPERAND 2 


31 

1 
1 
1 








RSL 


OpCode | R1 | R3 | B2 | D2 


| 




I 
I 
| 


7 


8 1112 1516 1920 

1 
IMMEDIATEl ADDRESS OF 
OPERAND | OPERAND 1 


31 

1 
1 






»L 


Op Code 


12 1 B1 | D1 | 




I 
I 


7 


8 1516 1920 

i ADDRESS OF 
OPERAND 2 


31 

1 
1 
1 






V 


s[ 


OpCode | B2 | D2 


1 







15 16 1920 


31 



[LI |L2/I3~|~ 



Hi 



78 1112 1516 1920 



3132 3536 



Op Code 



1516 1920 



3132 3536 



1 -6 OS/VS1 Programmer's Reference Digest 



Control Registers 



CR 


Bits 


Name of field 


Associated with 


Init. 








Block - multiplex'g control 


Block - multiplex'g 







1 


SSM suppression control 


SSM instruction 







2 


TOD clock sync control 


Multiprocessing 







8-9 


Page size control \ 









10 


Unassigned (must be zero) / 


Dynamic addr. transl . 







11 -12 


Segment size control ) 









16 


Malfunction alert mask \ 









17 


Emergency signal mask f 


Multiprocessing 







18 


External call mask I 







19 


TOD clock sync check mask / 









20 


Clock comparator mask 


Clock comparator 







21 


CPU timer mask 


CPU timer 







24 


Interval timer mask 


Interval timer 


1 




25 


Interrupt key mask 


Interrupt key 


1 




26 


External signal mask 


External signal 


1 


1 


0-7 


Segment table length "1 
Segment table address / 









8-25 


Dynamic addr. transl. 





2 


0-31 


Channel masks 


Channels 


1 


8 


16-31 


Monitor masks 


Monitoring 





9 



1 


Successful branching event mask \ 
Instruction fetching event mask / 










2 


Storage alteration event mask > 


Program -event record'g 







3 


GR alteration event mask \ 








16-31 


PER general register masks / 







10 


8-31 


PER starting address 


Program -event record'g 





11 


8-31 


PER ending address 


Program -event record'g 





14 





Check -stop control ) 
Synch. MCEL control / 




1 




1 


Machine -check handling 


1 




2 


I/O extended logout control 


I/O extended logout 







4 


Recovery report mask \ 









5 


Degradation report mask j 









6 
7 


Ext. damage report mask f 
V/arning mask / 


Machine -check handling 


1 






8 


Asynch . MCEL control • I 









9 


Asynch . fixed log control J 







15 


8-28 


MCEL address 


Machine -check handling 


512 



Section 1: General Information 1-7 



Condition Codes 



Condition Code Setting 





1 


2 


3 


Mask Bit Value 


8 


4 


2 


1 


General Instructions 










Add, Add Ha If word 


zero 


< zero 


> zero 


overflow 


Add Logical 


zero, 


not zero, 


zero, 


not zero, 




no carry 


no carry 


carry 


carry 


AND 


zero 


not zero 


— 


— 


Compare, Compare Halfword 


equal 


1st op low 


1st op high 


- 


Compare and Swap/Double 


equal 


not equal 


— 


— 


Compare Logical 


equal 


1st op low 


1st op high 


— 


Exclusive OR 


zero 


not zero 


— 


— 


Insert Characters under Mask 


all zero 


1st bit one 


1st bit zero 


— 


Load and Test 


zero 


< zero 


> zero 


— 


Load Complement 


zero 


< zero 


> zero 


overflow 


Load Negative 


zero 


< zero 


— 


— 


Load Positive 


zero 


— 


> zero 


overflow 


Move Long 


count equal 


count low 


count high 


overlap 


OR 


zero 


not zero 


— 


— 


Shift Left Double/Single 


zero 


< zero 


>zero 


overflow 


Shift Right Double/Single 


zero 


< zero 


> zero 


- 


Store Clock 


set 


not set 


error 


not oper 


Subtract, Subtract Halfword 


zero 


< zero 


> zero 


overflow 


Subtract Logical 


- 


not zero, 


zero, 


not zero, 






no carry 


carry 


carry 


Test and Set 


zero 


one 


— 


— 


Test under Mask 


zero 


mixed 


— 


ones 


Translate and Test 


zero 


incomplete 


complete 


- 


Decimal Instructions 










Add Decimal 


zero 


< zero 


> zero 


overflow 


Compare Decimal 


equal 


1st op low 


1st op high 


— 


Edit, Edit and Mark 


zero 


< zero 


> zero 


— 


Shift and Round Decimal 


zero 


< zero 


> zero 


overflow 


Subtract Decimal 


zero 


< zero 


> zero 


overflow 


Zero and Add 


zero 


< zero 


> zero 


overflow 


Floating-Point Instructions 










Add Normalized 


zero 


< zero 


> zero 


— 


Add Unnormalized 


zero 


< zero 


> zero 


— 


Compare 


equal 


1st op low 


1st op high 


- 


Load and Test 


zero 


< zero 


> zero 


— 


Load Complement 


zero 


< zero 


> zero 


— 


Load Negative 


zero 


< zero 


— 


— 


Load Positive 


zero 


— 


> zero 


— 


Subtract Normalized 


zero 


< zero 


> zero 


— 


Subtract Unnormalized 


zero 


< zero 


> zero 


- 


Input/Output Instructions 










Clear I/O 


no oper in 
progress 


CSW stored 


chan busy 


not oper 


Halt Device 


interruption 
pending 


CSW stored 


channel 
working 


not oper 


Halt I/O 


interruption 
pending 


CSW stored 


burst op 
stopped 


not oper 


Start I/O, SIOF 


successful 


CSW stored 


busy 


not oper 


Store Channel ID 


ID stored 


CSW stored 


busy 


not oper 


Test Channel 


available 


interruption 
pending 


burst mode 


not oper 


Test I/O 


available 


CSW stored 


busy 


not oper 


System Control Instructions 










Load Real Address 


translation 


ST entry 


PT entry 


length 




available 


invalid 


invalid 


violation 


Reset Reference Bit 


R = 0, C = 


R = 0, C=l 


R=l, C=0 


R=l, C=l 


Set Clock 


set 


secure 


— 


not oper 


Signal Processor 


accepted 


stat stored 


busy 


not oper 



1 -8 OS/VS1 Programmer's Reference Digest 



Program Interruption Codes - CNOP Alignment - Edit EDMK Pattern 
Characters 

PROGRAM INTERRUPTION CODES 



Interruption 
Code 


Program Interruption 
Cause 


Interruption 
Code 


Program Interruption 
Cause 


Dec 


Hex 


Dec 


Hex 


1 


0001 


Operation 


12 


oooc 


Exponent overflow 


2 


0002 


Privileged operation 


13 


000D 


Exponent underflow 


3 


0003 


Execute 


14 


000E 


Significance 


4 


0004 


Protection 


15 


000F 


Floating - point divide 


5 


0005 


Addressing 


16 


0010 


Segment translation 


6 


0006 


Specification 


17 


0011 


Page translation 


7 


0007 


Data 


18 


0012 


Translation specification 


8 


0008 


Fixed -point overflow 


19 


0013 


Special operation 


9 


0009 


Fixed -point divide 


64 


0040 


Monitor event 


10 


000A 


Decimal overflow 


128 


0080 


Program event (code may 


11 


000B 


Decimal divide 






be combined with 
another code) 



CNOP ALIGNMENT 



Half Word 



Half Word 



Half Word 



Byte { Byte 



Byte ; Byte 



Byte 



Byte 



Byte 



Byte 



0,4 
0,8 



EDIT AND EDMK PATTERN CHARACTERS (in hex) 
20 -digit selector 40-blank 5C -asterisk 

21 -start of significance 4B- period 6B- comma 

22 -field separator 5B -dollar sign C3D9-CR 



Section 1 : General Information 1 -9 



Area, 


Hex 


dec. 


addr 


0-7 





8-15 


8 


16-23 


10 


24-31 


18 


32-39 


20 


40-47 


28 


48-55 


30 


56-63 


38 


64-71 


40 


72-75 


48 


80-83 


50 


83-95 


58 


96-103 


60 


104-111 


68 


112-119 


70 


120-127 


78 


132-133 


84 


132-133 


84 


134-135 


86 


136-139 


88 



Fixed Storage Locations 

Purpose 

Initial program loading PSW, restart new PSW 

Initial program loading CCW1, restart old PSW 

Initial program loading CCW2 

External old PSW 

Supervisor Call old PSW 

Program old PSW 

Machine-check old PSW 

Input/output old PSW 

Channel status word 

Channel address word 

Interval timer 

Externa! new PSW 

Supervisor Call new PSW 

Program new PSW 

Machine-check new PSW 

Input/output new PSW 

CPU address assoc'd with external interruption , or unchanged 

CPU address assoc'd with external interruption, or zero (EC 

mode only) 

External interruption code (EC mode only) 

SVC interruption [0-12 zeros, 13-14 ILC, 15:0, 16-31 code] 

(EC mode only) 
8C Program interrupt [0-12 zeros, 13-14 ILC, 15:0, 16-31 code] 

(EC mode only) 
90 Translation exception address [0-7 zeros, 8-31 address] (EC 

mode only) 

Monitor class [0-7 zeros, 8-15 class number] 

PER interruption code [0-3 code, 4-15 zeros] (EC mode only) 

PER address [0-7 zeros, 8-31 address] (EC mode only) 

Monitor code [0-7 zeros, 8-31 monitor code] 

Channel ID [0-3 type, 4-15 model, 16-31 max. IOEL length] 

I/O extended logout (IOEL) address [0-7 unused, 8-31 addr] 

Limited channel logout (see diagram) 

I/O address [0-7 zeros, 8-23 address] (EC mode only) 

CPU timer save area 

Clock comparator save area 

Machine-check interruption code 

Failing processor storage address [0-7 zeros, 8-31 addr] 

Region code* 

Machine-check fixed logout area* 

Machine-check floating-point register save area 

Machine-check general register save area 

Machine-check control register save area 

Machine-check CPU extended logout area (size varies) 

* Functions and use of fields may vary among models. See system library 

manuals for specific model . 
t Location may be changed by programming (bits 8-28 of CR15 specify address). 



148-149 


94 


150-151 


96 


152-155 


98 


156-159 


9C 


168-171 


AB 


172-175 


AC 


176-179 


B0 


185-187 


B9 


216-223 


D8 


224-231 


E0 


232-239 


E8 


248-251 


F8 


252-255 


FC 


256-351 


100 


352-383 


160 


384-447 


180 


448-511 


1C0 


512- t 


200 



1-10 OS/VS1 Programmer's Reference Digest 



PSW (BC and EC modes) 

PROGRAM STATUS WORD (BC Mode) 



Channel Masks 


E 


Protect'n 
Key 


CMWP 


Interruption Code 


6 


7 


8 11 


12 15 


16 23J24 31 


ILC 


cc 


Program 
Mask 


Instruction Address 


32 


34 


36 


39 


40 


47 


48 55l56 63 



0-5 Channel to 5 masks 

6 Mask for channel 6 and up 

7 (E) External mask 

12 (C=0) Basic control mode 

13 (M) Machine-check mask 

14 (W=1) Wait state 

15 (P=1) Problem state 



32-33 (ILC) Instruction length code 
34-35 (CC) Condition code 

36 Fixed-point overflow mask 

37 Decimal overflow mask 

38 Exponent underflow mask 

39 Significance mask 



PROGRAM STATUS WORD (EC Mode) 



0R00 OTIE 


Protect'n 
Key 


CMWP 


00 


CC 


Program 
Mask 


0000 0000 


3 7 


8 11 


12 15 


16 


18 


20 23 


24 31 



0000 0000 



Instruction Address 
47I48 55 



1 (R) Program event recording mask 

5 (T=1) Translation mode 

6 (I) Input/output mask 

7 (E) External mask 

12 (C=1) Extended control mode 

13 (M) Machine-check mask 

14 (W=1) Wait state 



15 (P=1) Problem state 
18-19 (CC) Condition code 

20 Fixed-point overflow mask 

21 Decimal overflow mask 

22 Exponent underflow mask 

23 Significance mask 



Section 1: General Information 1.-11 



CAW - CCW - CSW 

CHANNEL ADDRESS WORD (hex 48) 



Key 


0000 


Command Address 


3 


4 7 


8 1 5 1 1 6 23J24 31 



CHANNEL COMMAND WORD 



Command Code 


Data Address 


7 


8 15|l6 2324 31 




CD-bit 32 (80) causes use of address portion of next CCW. 
CC— bit 33 (40) causes use of command code and data address of next CCW. 
SLI— bit 34 (20) causes suppression of possible incorrect length indication. 
Skip-bit 35 (10) suppresses transfer of information, to main storage. 
PCI— bit 36 (08) causes a channel program controlled interruption. 
IDA-bit 37 (04) causes bits 8-31 of CCW to specivy location of first I DAW. 



CHANNEL STATUS WORD (hex 40) 




Key 





L 


CC 


CCW Address 


3 


4 


5 


6 7 


8 15ll6 23|24 


31 



Unit Status 



Channel Status 



Byte Count 



32 39 40 

5 Logout pending 

6-7 Deferred condition code 

32 (8000) Attention 

33 (4000) Status modifier 

34 (2000) Control unit end 
35(1000) Busy 

36 (0800) Channel end 

37 (0400) Device end 

38 (0200) Unit check 

39 (0100) Unit exception 



4 8 55156 

40 (0080) Program control interruption 

41 (0040) Incorrect length 

42 (0020) Program check 

43 (0010) Protection check 

44 (0008) Channel data check 

45 (0004) Channel control check 

46 (0002) Interface control check 

47 (0001) Chaining check 

48-63 Residual byte count for the last 
CCW used 



1-12 OS/VS1 Programmer's Reference Digest 



Limited Channel Logout - Machine-check Interruption Code 
LIMITED CHANNEL LOGOUT (hex 80) 






SCU id 


Detect 


Source 


000 


Field validity flags 


TT 


00 


A 


Seq. 





1 3 


4 7 


8 12 


13 15 


16 23 


24 


26 


28 


29 3i 



Detect field 

4 CPU 

5 Channel 

6 Storage control unit 

7 Storage unit 
Source field 

\ 8 CPU 

J 9 Channel 

10 Storage control unit 

11 Storage unit 

12 Control unit 
16-23 Field validity flags 

16 Interface address 



17-18 Reserved (00) 

19 Sequence code 

20 Unit status 

21 Command address and key 

22 .Channel address 

23 Device address 
24-25 (TT) Type of termination 

Code 00 Interface disconnect 
01 Stop, stack, or normal 

10 Selective reset 

1 1 System reset 
28 (A) I/O error alert 

29-31 Sequence code 



MACHINE-CHECK INTERRUPTION CODE (hex E8) 




MC conditions 


000 00 


Time 


Stg. 
error 





Validity indicators 


8 


9 )3 


14 


16 13 


IV 


20 31 



0000 



0000 0000 

39 U0 



00 Val. 



MCEL length 
55'56 



32 



45 "46 



System damage 14 Backed-up 

1 Instr. proc'g damage 15 Delayed 

2 System recovery 16 Uncorrected 

3 Timer damage 17 Corrected 

4 Timing facil. damage 18 Key uncorrected 

5 External damage 20 PSW bits 12-15 

6 Not assigned (0) 21 PSW masks and key 

7 Degradation 22 Prog . mask and CC 

8 Warning 23 Instruction address 



'48 



63 



24 Failing stg . address 

25 Region code 

27 Floating-pt registers 

28 General registers 

29 Control registers 

30 CPU ext'd logout 

31 Storage logical 

46 CPU timer 

47 Clock comparator 



Section 1: General Information 1-13 



I/O Command Codes 

Standard Command Code Assignments (CCW bits 0-7) 



xxxx 


0000 


Invalid 


tttt 


ttoi 


Write 


tttt 


0100 


Sense 


tttt 


ttio 


Read 


xxxx 


1000 


Transfer in Channel 


tttt 


ttll 


Control 


tttt 


1 100 


Read Backward 


0000 


001 1 


Control No Operation 



-Bit ignored. 



TModifier bit for specific type of I/O device 



CONSOLE PRINTERS 



Write, No Carrier Return 01 

Write, Auto Carrier Return 09 

Read Inquiry 0A 



Sense 
Audible Alarm 



04 
0B 



3504, 3505 CARD READER/3525 CARD PUNCH 




(GA21-9124) 


Command 


Binary 


Hex 


Bit Meanings 


Sense 


0000 0100 


04 


SS 


Stacker 


Feed, Select Stacker 


SS10 F011 




00 


1 


Read Only* 


11D0 F010 




01 


2 


Diagnostic Read 


1101 0010 


D2 


10 


2 


Read, Feed, Select Stacker* 


SSD0 F010 




F 


Format Mode 


Write RCE Format* 


0001 0001 


11 





Unformatted 


3504, 3505 only 


0011 0001 


31 


1 
D 


Formatted 


Write OMR FormatT 


Data Mode 











1-EBCDIC 


3525 only^ 

Write, Feed, Select Stacker 


SSD0 0001 




1 


2-Card image 


Print Line* 


LLLL L101 




L 
5-b 


Line Position 
it binary value 



*Special feature on 3525 



tSpecial feature 



PRINTERS: 3211/3811 (GA24-3543), 3203/lPA, 1403/2821* (GA24-3312) 





After 










Write 


Immed 






Space 1 Line 


09 


0B 


Write without spacing 


01 


Space 2 Lines 


11 


13 


Sense 


04 


Space 3 Lines 
Skip to Channel ' 


19 


IB 


Load UCSB without folding 


FB 


- 


83 


Foldt 


43 


Skip to Channel 1 


89 


8B 


Unfoldt 


23 


Skip to Channel 2 


91 


93 


Load UCSB and Fold (exc . 321 1 ) 


F3 


Skip to Channel 3 


99 


9B 


UCSGate Load (1403 only) 


EB 


Skip. to Channel 4 


Al 


A3 


Load FCBt 


63 


Skip to Channel 5 


A9 


AB 


Block Data Check 


73 


Skip to Channel 6 


Bl 


B3 


Allow Data Check 


7B 


Skip to Channel 7 


B9 


BB 


Read PLBt 


02 


Skip to Channel 8 


CI 


C3 


Read UCSBT 


0A 


Skip to Channel 9 


C9 


CB 


Read FCBt 


12 


Skip to Channel 10 


Dl 


D3 


Diag. Check Read (exc. 3203) 


06 


Skip to Channel 1 1 


D9 


DB 


Diagnostic Write! 


05 


Skip to Channel 12 


El 


E3 


Raise Covert 
Diagnostic Gate t 
Diagnostic Read (1403 only) 


6B 
07 
02 



* 1403/1 PA diagnostics are model -dependent; 
UCS special feature on 1403 



t3211 only 



1-14 OS/VS1 Programmer's Reference Digest 



I/O Command Codes (cont'd) 

3420/3803, 3410/341 1 MAGNETIC TAPE 

See GA32-0020, -0021 , -0022 for function of specific models and special 

features required. 











Density 


Parity 


DC 


Trans 


Cmd 


Write 




01 






f. 


\ odd 


f on 


off 


13 


Read Forward 




02 








1 off ■ 


r off 


33 


Read Backward 




OC 






200 


< 


on 


3B 


Sense 




04 








/ 




foff 


23 . 


Sense Reserve*^" 




F4 








f even 


off 


on 


2B 


Sense Release*' 




D4 








/ 


( on 


off 


53 


Request Track-in- 


•Error 


IB 


Mode 






\ odd 




(off 


73 


Loop V/rite-to-Readt 


8B 


Set 1 


-< 


556 


< 


ff 
^ off 


on 


7B 


See Diagnoset 




4B 


(7-track) 




/ 




'off 


63 


Rewind 




07 








f even 


off 


on 


6B 


Rewind Unload 




OF 








/ 


( on 


off 


93 


Erase Gap 




17 








\ odd 


[ off 


off 


B3 


Write Tape Mark 




IF 






800 


<^ 


.on 


BB 


Backspace Block 




27 








J 


off 


foff 


A3 


Backspace File 




2F 






. 


^ even 


^on 


AB 


Forward Space Bl 
Forward Space Fi 


ock 

e 


37 
3F 


Mode Set 2 (9- 


track) 






CB 
C3 
D3 


Data Security Erase t 


97 




1600 bpi 
6250 bpit 








Diagnostic Mode 


Sett 


0B 











*Two-channel switch required 



t3420 only 



DIRECT ACCESS STORAGE DEVICES: 

3330-3340 SERIES (GA26-1592, -1617, -1619, -1620); 

2305/2835 (GA26-1589); 2314, 2319 (GA26-3599, -1606) 



Command 


MTOff 


MTOn* 


Count 


Control 


Orient (c) 


28 




Nonzero 




Recalibrate 


13 




Nonzero 




Seek 


07 




6 




Seek Cylinder 


0B 




6 




Seek Head 


IB 




6 




Space Count 


OF 




3 (a); nonzero (d) 




Set File Mask 


IF 




1 




Set Sector (a,f) 


23 




1 




Restore (executes as a no-op] 


17 




Nonzero 




Vary Sensing (c) 


27 




1 




Diagnostic Load (a) 


53 




1 




Diagnostic Write (a) 


73 




512 


Search 


Home Address Equal 


39 


B9 


4 




Identifier Equal 


31 


Bl 


5 




Identifier High 


51 


Dl 


5 




Identifier Equal or High 


71 


Fl 


5 




Key Equal 


29 


A9 


KL 




Key High 


49 


C9 


KL 




Key Equal or High 


69 


E9 


KL 




Key and Data Equal (d) 


2D 


AD 


N 

Number 
of bytes 
(including 
► mask bytes) 
in search 




Key and Data High (d) 


4D 


CD 




Key and Data Eq. or Hi (d) 


6D 


ED 


Continue 


Search Equal (d) 


25 


A5 


Scan 


Search High (d) 


45 


C5 




Search High or Equal (d) 


65 


E5 




Set Compare (d) 


35 


B5 


argument 




Set Compare (d) 


75 


F5 






No Compare (d) 


55 


D5 


> 



* Code same as MT Off except as listed. 

a. Except 2314, 2319 

b. 3330-3340 Series only; 
manual reset on 3340. 

c. 2304/2835 only. 



d. 2314, 2319 only. 

e. String switch or 2-channel 
switch feature required; 
standard on 2314 and 2844. 

f. Special feature required on 3340. 



Section 1: General Information 1-15 



I/O Command Codes (cont'd) - ANSI Control Characters 

DIRECT ACCESS STORAGE DEVICES: (cont'd) 
3330-3340 SERIES (GA26-1592, -1617, -1619, 1620); 
2305/2835 (GA26-1589); 2314, 2319 (GA26-3599, -1606) 



Command 


MT Off 


MT On* 


Count 


Read 


Home Address 


1A 


9A 


5 




Count 


12 


92 


. 8 




Record 


16 


96 


\ 




Data 


06 


86 


/ Number of 




Key and Data 


05 


8E 


> bytes to be 




Count, Key and Data 


IE 


9E 


\ transferred 




IPL 


02 




) 




Sector (a,f) 


22 




1 


Sense 


Sense I/O 


04 




24 (a); 6 (d) 




Read, Reset Buffered Log (b) 


A4 




24 




Read Buffered Log (c) 


24 




128 




Device Release (e) 


94 




24 (a); 6 (d) 




Device Reserve (e) 


B4 




24 (a); 6 (d) 




Read Diagnostic Status 1 (a) 


44 




16 or 512 


Write 


Home Address 


19 




5 (exc . 7 on 3340) 




Record 


15 




8+KL+DLof R0 




Erase 


11 




8+KL+DL 




Count, Key and Data 


ID 




8+KL+DL 




Special Count, Key and Data 


01 




8+KL+DL 




Data 


05 




DL 




Key and Data 


0D 




KL+DL 



* Code same as MT Off except as listed. 

a. Except 2314, 2319. 

b. 3330-3340 Series only; 
manual reset on 3340. 

c. 2304/2835 only. 



d. 23U, 2319 only. 

e. String switch or 2-channel 
switch feature required; 
standard on 2314 and 2844. 

f . Special feature required on 
3340. 



ANSI Control Characters 



Code Action Before Printing a Line 



tf 


Space one line (blank code) 





Space two lines 


- 


Space three lines 


+ 


Suppress space 


1 


Skip to channel 1 


2 


Skip to channel 2 


3 


Skip to channel 3 


4 


Skip to channel 4 


5 


Skip to channel 5 


6 


Skip to channel 6 


7 


Skip to channel 7 


8 


Skip to channel 8 


9 


Skip to channel 9 


A 


Skip to channel 10 


B 


Skip to channel 1 1 


C 


Skip to channel 12 


!ode 


Action After Punching a Card 


V 


Select punch pocket 1 


W 


Select punch pocket 2 



1-16 OS/VS1 Programmer's Reference Digest 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Add 


A 


5A 


RX 


Rl, D2(X2,B2) 


Add opr 2 to opr 1 
(Sto) (Reg) 


Addr 
Specif 

Fxpt Oflo 


Sum = 

1 Sum < 

2 Sum > 

3 Overflow 


Add 


AR 


1A 


RR 


Rl, R2 


Add opr 2 to opr 1 

(GPR) (Reg) 


Fxpt Ofio 


Sum = 

1 Sum < 

2 Sum >0 

3 Overflow 


Add 
Decimal 


AP 


FA 


SS 


D1(L1,B1), 
D2(L2,B2) 


Add dec opr 2 to opr 1 

(Sto) (Sro) 
(Right to left byte by byte). 
(Opr 1 and 2 must be in packed) 
(Fields can overlap if low-order 

bytes coincide) 
(If opr 1 and opr 2 refer to same 
field, the field is doubled) 


Addr 

Data 

Dec Oflo 
Protect 
Opera 


Sum = 

1 Sum<0 

2 Sum > 

3 Overflow 


Add 
Halfwoid 


AH 


4A 


RX 


Rl, D2(X2,B2) 


Add opr 2 to opr 1 

(Sto) (Reg) 
(High-order 16 bits expanded) 
opr 2 


Addr 

Fxpt Oflo 
Specif 


Sum = 

1 Sum < 

2 Sum > 

3 Overflow 


Add 
Logical 


AL 


5E 


RX 


Rl, D2(X2,B2) 


Add log opr 2 to opr 1 
(Sto) (Reg) 


Addr 
Specif 


Sum = 

1 Sum * 

2 Sum = 

3 Sum * 


Add 
Logical 


ALR 


IE 


RR 


Rl, R2 


Add log opr 2 to opr 1 
(Reg) (Reg) 


None 


Sum = 

1 Sum * 

2 Sum = 

3 Sum * . 



Operation 


Mnemonic " 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Add 

Normalized 

(Extended) 


AXR 


36 


RR 


R1, R2 


FP Add opr 2 to opr 1 

(FPRpair) (FPR pair) 
Extended sum is put in opr 1 (FPR pair) 
Each operand consists of two FPR 
Only FPR and FPR 4 may be specified for 
opr 1 or opr 2. 


Specif 
Exp Oflo 
Exp Uflo 
Signif 
Opera 


Fract = 

1 Result <0 

2 Result >0 


Add 

Normalized 

(Long) 


AD 


6A 


RX 


Rl, D2(X2,B2) 


FP Add opr 2 to opr 1 
(Sto) (FPR) 


Addr 
Specif 
Signif 
Exp Oflo 
Exp Uflo 
Opera 


Fract = 

1 Result <0 

2 Result >0 


| S | Char | Fraction | 
1 78 63 


Add 

Normalized 

(Long) 


ADR 


2A 


RR 


Rl, R2 


FP Add opr 2 to opr 1 
(FPR) (FPR) 


Specif 
Opera 
Signif 
Exp Oflo 
Exp Uflo 


Fract = 

1 Result< 

2 Result >0 


Add 

Normalized 

(Short) 


AE 


7A 


RX 


Rl, D2(X2,B2) 


FP Add opr 2 to opr 1 

._. (&o), ( FPR ) , 

1 S | Char | Fraction | 
1 7 8 31 

(Low-order halves of FPR ignored and 
unchanged) 


Addr 
Specif 
Signif 
Exp Oflo 
Exp Uflo 


Fract = 

1 Result <0 

2 Result > 


Add 

Normalized 

(Short) 


AER 


3A 


RR 


Rl, R2 


FP Add opr 2 to opr 1 
(FPR) (FPR) 

(Low-order halves of FPR ignored and 
unchanged) 


Specif 

Signif 
Exp Oflo 
Exp Uflo 


Fract = 

1 Result <0 

2 Result > 



Operation 


Mnemonic 


Op Cede 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Add 

Unnormalized 

(Long) 


AW 


6E 


P.X 


RI, D2(X2,B2) 


FP Add opr 2 to opr 1 

(Sto) (FPR) 


Add.- 

Specif 

Signif 

ExpOflo 

Opera 


Fract --- 

1 Result < 

2 Result >0 


Add 

Unnormalized 

(Long) 


AWR 


2E 


RR 


R1,R2 


FP Add opr 2 to opr 1 
(FPR) (FPR) 


Sp.cif 
Signif 
ExpOflo 
Opeia 


Fract = C 

1 Result < 

2 Result >0 


Add 

Unnormalized 

(Short) 


AU 


7E 


RX 


.Rl, D2(X2,B2) 


FP Add opr 2 to opr 1 
(Sto) (FPR) 

(Low-order halves of FPR ignored end 
unchanged) 


Addr 
Specif 
Signif 
Exp Oflo 
Opera 


Fract = 

1 Result <0 

2 Result > 


Add 

Unnorr.ialized 

(Short) 


AUR 


3E 


RR 


Rl, R2 


FP Add opr 2 to opr 1 

(FPR) (FPR) 
(Low-order halve; of FPR ignored ond 
unchanged) 


Specif 
Signif 
ExpOflo 
Opera 


Fract = 

1 Result <0 

2 Result > 


AND 


N 


54 


RX 


Rl, D2(X2,B2) 


Place the product of both cpr's into opr 1 


Addr 
Specif 


Result = 

1 Result *Q 


AND 


NC 


D4 


SS 


D1(L,B1), D2(B2) 


Place the product of both opr's into opr 1 

(Left to right byte by byte) 

(Max number of bytes ANDed: 256) 


Addr 
Protect 


Result = 

1 Result t 


AND 


NR 


14 


RR 


Rl, R2 


Place the product of both opr's into opr 1 


None 


Result = 

1 Result * 


AND 


Nl 


94 


SI 


D1(B1), !2 


AND the 1 byte from the instruction stream 
(8-15) to opr 1 


Addr 
Protect 


Result = 

1 Result * 



2 

o 

3 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Branch and 
Link 


BAL 


45 


RX 


R1, D2(X2,B2) 


Store ILC,CC prog mask, and 24 bits of 
inst adr in opr 1 . Branch to adr of opr 2 


None 


Unchanged 


Branch and 
Link 


BALR 


05 


RR 


Rl, R2 


Store ILC,CC prog mask, and 24 bits of 
inst adr in opr 1 . Branch to adr of opr 2 
(If opr 2=0, store, no branch) 


None 


Unchanged 




BC 


47 


RX 


Ml, D2(X2,B2) 


Compare opr 1 with cond code 
(Mask) 8-11 

(Mask = 7) Branch on non-zero cond code 

(Mask = 15) Uncond branch 

(Mask = 8) Cond code 00 

(Mask = 4) Cond code 01 

(Mask = 2) Cond code 10 

(Mask = 1 ) Cond code 1 1 

(NOP if cond not met) 




Unchanged 


Branch on 
Condition 


BCR 


07 


RR 


Ml, R2 


Compare opr 1 with cond code 
Branch to opr 2 adr if cond met 
(If opr 2=0) NOP 


None 


Unchanged 


s;nt hon 


BCT 


. 46 


RX 


Rl, D2(X2,B2) 


Reduce opr 1 by 1 and branch to opr 2 adr 
(If opr 1=1) Reduce, no branch 


None 


Unchanged 


Branch on 


BCTR 


06 


RR 


Rl, R2 


Reduce opr 1 by 1 and branch to opr 2 adr 
(If opr 1=1) Reduce, no branch 
(If opr 2 = 0) Reduce, no branch 


None 


Unchanged 


Branch on Equal 


BE 


47(BC 8) 


RX,Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Equal 


BER 


07(BCR 8 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on High 


BH 


47(BC 2) 


RX,Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on High 


BHR 


07(BCR2) RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on 
Index High 


BXH 


86 


RS 


Rl, R3, D2(B2) 


Add opr 3 to opr 1 

Sum compared to opr 3 if opr 3 adr is odd 
Sum compared to opr 3+1 if opr 3 addr is 
even. Branch to opr 2 addr if sum > 
3/opr 3 + 1 


None 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Branch on Index 
Low or Equal 


BXLE 


87 


RS 


Rl, R3, D2(B2) 


Same as Branch On Index High 

Branch to opr 2 adr if sum <or = opr 3+1 


None 


Unchanged 


Branch on Low 


BL 


47(BC 4) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Low 


BLR 


07(BCR4) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch if Mixed 


BM 


47(BC 4) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch if Mixed 


'BMR 


07(BCR 4) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Minus 


BM 


47(BC 4) 


RX,Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Minus 


BMR 


07(BCR 4) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Equal 


BNE 


47(BC 7) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Equal 


BNER 


07(BCR 7) 


RR, Ext . 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not High 


BNH 


47(BC 13) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not High 


BNHR 


07(BCR 13) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Low 


BNL 


47(BC 11) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Low 


BNLR 


07(BCR 11) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Minus 


BNM 


47(BC 1 1 ) 


RX ; Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Minus 


BNMR 


07(BCR 11) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Ones 


BNO 


47(BC 14) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Ones 


BNOR 


07(BCR 14) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Plus 


BNP 


47(BC 13) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Plus 


BNPR 


07(BCR 13) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Zeros 


BNZ 


47(BC 7) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Not Zeros 


BNZR 


07(BCR 7) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 



Ext - Extended Mnemonic 



o 

< 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Branch if Ones 


BO 


47(BC 1 )~~ 


RX,Ext'."" 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch if Ones 


BOR 


07(BCR 1) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Overflow 


BO 


47(BC 1) 


RX,Ext. 


D2 (X2, B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Overflow 


BOR 


07(BCR 1) 


RR, Ext . 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Plus 


BP 


47(BC 2) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Plus 


BPR 


07(BCR 2) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch if Zeros 


BZ 


47(BC 8) 


RX,Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch if Zeros 


BZR 


07(BCR8) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch on Zero 


BZ 


47(BC 8) 


RX,Ext. 


D2 (X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch on Zero 


BZR 


07(BCR 8) 


RR,Ext. 


R2 


Branch if mask = cond code 


None 


Unchanged 


Branch Unconditional 


B 


47(BC 15) 


RX,Ext. 


D2(X2,B2) 


Branch if mask = cond code 


None 


Unchanged 


Branch Unconditional 


BR 


07(BC 15) 


RR, Ext . 


R2 


Branch if mask = cond code 


None 


Unchanged 


Clear I/O 


CLRIO 


9D01 


S 


D2 (B2) 


Terminate execution of current I/O op at 
addressed dev. 


Priv 


opr's = 

1 CSW stored 

2 channel or 
subchannel 
busy 

3 not oprtnal 


Compare 


C 


5? 


RX 


Rl, D2(X2,B2) 


Compare opr 1 algebraically to opr 2 (Reg) 


Addr 
Specif 


opr's = 

1 1st < 

2 1st > 


Compare 


CR 


19 


RR 


Rl, R2 


Compare opr 1 algebraically to opr 2 


None 


opr's = 

1 1st < 

2 1st > 



Ext = Extended Mnemonic 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Compare and Swap 


CS 


BA 


RS 


R1,R3,D2(B2) 


Compare opr 1 to opr 2. Store opr 3 in 
opr 2 if =, store opr 2 in opr 1 if f. 


Addr 
Specif 
Protect 
Opera 


1 1st = 2nd; 
2nd replaced 
by 3rd 


Compare Decimal 


CP 


F9 


SS 


Dl (L1,B1), D2(L2,B2) 


Compare opr 1 to opr 2 

(binary right to left) byte by byte 

(Opr's must be packed) 

(Fields can overlap if low-order bytes 

coincide) 

(The shorter opr is extended with high-order 


Addr 
Data 
Opera 


opr's = 

1 1st < 

2 1st > 


Compare Double 
and Swap 


CDS 


BB 


RS 


Rl, R3, D2(B2) 


Compare opr 1 to opr 2. Store opr 3 in 
opr 2 if =, store opr 2 in opr 1 if f. 


Addr 
Specif 

Opera 


opr's = 

1 1st =2nd 
2nd replaced 
by 3rd 


Compare Halfword 


CH 


49 


RX 


Rl, D2(X2,B2) 


Compare opr 1 algebraically to opr 2 
(Hi-order 16 bits expanded) opr 2 


Addr 
Specif 


opr's = 

1 1st < 

2 1st > 


Compare Logical 


CL 


55 


RX 


Rl, D2(X2,B2) 


Compaie opr 1 to opr 2 
(binary left to right) 
(Terminates if/when /found) 


Addr 
Specif 


opr's = 

1 1st < 

2 1st > 


Compare Logical 


CLC 


D5 


SS 


Dl (L,B1), D2(B2) 


Compare opr 1 to opr 2 
(binary left to right) 
(Terminated if/when f found) 
(opr length max 256 bytei) 


Specif 


opr's = 

1 1st < 

2 1st > 


Immediate 


CLI 


95 


SI 


Dl (Bl), 12 


Compare opr 1 to opr 2 

(Imm) (Sto) 
(binary left to right) 
(Terminates if/when f found) 


Addr 


opr's = . 

1 1st < 

2 1st > 


Compare Logical 


CLR 


15 


RR 


Rl, R2 


Compare opr 1 to opr 2 
(binary left to right) 
(Terminates if/when = found) 


Addr 


1 1st < 

2 1st > 


Compare Logical 
Characters Under Mask 


CLM 


BD 


RS 


Rl, M3,D2(B2) 


Compare opr 2 to opr 1 under control 
of mask (binary left to right) 


Addr 

Protect 

Opera 


Selected by bytes = 
or mask = 

1 Selected field 
1st opr is low 

2 Selected Field 
1st opr is high 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Compare Logical Long 


CLCL 


OF 


RR 


Rl, R2 


Compare opr 1 to opr 2 

(opr 1 and 2 indicate even/odd reg. pair) 


Addr 
Specif 
Opera 
Protect 


opr's = 

1 1st < 

2 1st > 

3 — 


Compare (Long) 


CD 


69 


RX 


Rl, D2(X2,B2) 


Compare opr 1 algebraically to opr 2 
(Equalize and subtract) 


Addr 

Specif 

Opera 


opr's = 

1 1st < 

2 1st > 


Compare (Long) 


CDR 


29 


RR 


Rl, R2 


Compare opr 1 algebraically to opr 2 (FPR) 
(Equalize and subtract) 


Specif 

Addr 

Opera 


opr's = 

1 1st < 

2 1st > 


Compare (Short) 


CE 


79 


RX 


Rl, D2(X2,B2) 


Compare opr 1 algebraically to opr 2 

(FPR) (Sto) 
(Low-order halves of FPR ignored and 
unchanged) 


Addr 

Specif 

Opera 


opr's = 

1 1st < 

2 1st > 


Compare (Short) 


CER 


39 


RR 


Rl, R2 


Compare opr 1 algebraically to opr 2 

(FPR) (FPR) 
(Low-order halves of FPR ignored and 
unchanged) 


Specif 
Opera 


opr's = 

1 1st < 

2 1st > 


Convert to Binary 


CVB 


4F 


RX 


Rl, D2(X2,B2) 


Convert opr 2 (packed decimal) 
(Doubleword bounds) to binary and put in 
opr 1 location 


Addr 
Specif 
Data 
Fxpt Div 


Unchanged 


Convert to Decimal 


CVD 


4E 


RX 


Rl, D2(X2,B2) 


Convert opr 1 (binary) to packed decimal 
(doubleword bounds) and put in opr 2 


Addr 

Specif 

Protect 


Unchanged 


Diagnose 




83 




See IBM System/370 
Principles of Opera- 
tion, GA22-7000 


See IBM System/370 

Principles of Operation, GA22-7000 


Priv Oper 

Model 

dependent 


Unpredict- 
able 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Divide 


D 


5D 


RX 


RT, D2 (X2,B2) 


Divide opr 1 by opr 2 

(even and odd regs) (Sto) 

Opr 1 becomes remainder and quotient 


Addr 
Specif 
Fxpt Div 


Unchanged 


Divide 


DR 


ID 


RR 


Rl, R2 


Divide opr 1 by opr 2 
Dividend: even and odd pair regs 
Opr 1 becomes remainder and quotient 
(full word only) 


Specif 
Fxpt Div 


Unchanged 


Divide Decimal 


DP 


FD 


SS 


D1(L1,B1), 
D2(L2,B2) 


Divide opr 1 by opr 2 

Opr 1 becomes quotient and remainder 

(left justified) 

Dividend: at least 1 leading zero, max 

size 31 digits and sign 

Divisor: max size 15 digits and sign, 

numerically larger than dividend 

Both opr's packed format 

Remainder size = divisor size (Fields can 

overlap if low-order bytes coincide.) 


Addr 

Protect 

Specif 

Data 

Dec Div 

Opera 


Unchanged 


Divide (Long) 


DD 


6D 


RX 


R1,D2(X2,B2) 


FP Divide opr 1 by opr 2 

(FPR) (Sto) 
Opr 1 becomes quotient 
(prenormalized) 


Addr 
Specif 
Exp Oflo 
FP Div 
Opera 
Exp Uflo 


Unchanged 


Divide (Long) 


DDR 


2D 


RR 


Rl, R2 


FP Divideopr 1 by opr 2 
Prenormalize (FPR) (FPR) 

(Dividend) (Divisor) 
Oper 1 becomes quotient 


Specif 
Opera 
Exp Oflo 
Exp Uflo 
FP Div 


Unchanged 



o 

on 
< 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Divide (Short) 


DE 


7D 


RX 


R1, D2(X2,B2) 


FP Divide opr 1 by opr 2 
Prenormalize 

(Dividend) (Divisor) 
Opr 1 becomes quotient 
(Low-order halves of FPR ignored and 
unchanged) 


Addr 
Specif 
Exp Oflo 
Exp Uflo 
FP Div 
Opera 


Unchanged 


Divide (Short) 


DER 


3D 


RR 


Rl, R2 


FP Divide opr 1 by 2 
Prenormalize (FPR) (FPR) 

(Dividend) (Divisor) 
Opr 1 becomes quotient 
(Low-order halves of FPR ignored and 
unchanged) 


Specif 
Exp Oflo 
FPDiv 
Exp Uflo 
Opera 


Unchanged 


Edit 


ED 


DE 


SS 


D1(L,B1), D2(B2) 


Opr 1 = pattern, opr 2 = source 

Opr 2 is changed from packed to zoned and 

edited under control of opr 1 . 

Opr's processed left to right 

(Fill char is 1st char in pattern field unless 

it is a digit/select/significance-start char.) 

(Opr 1 terminates operation) 

See IBM System/370 Principles of 

Operation, GA22-7000 


Addr 
Data 
Opera 
Protect 


Source 

field = 

1 field <0 

2 field > 


Edit and Mark 


EDMK 


DF 


SS 


D1(L,B1), D2(B2) 


Same as Edit 

(Adr of 1st significant result digit 

recorded in G PR 1) 


Opera 
Addr 
Data 
Protect 


Source 

field = 

1 field <0 

2 field >0 


Exclusive OR 


X 


57 


RX 


Rl, D2(X2,B2) 


Exclusive-OR opr 2 and opr 1 and the 
modulo-two sum placed in opr 1 


Addr 
Specif 


Result =0 

1 Result *0 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Exclusive OR 


XC 


D7 


SS 


D1(L,B1), D2(B2) 


Exclusive-OR opr 2 and opr 1 and 
modulo-two sum placed in opr 1 . 


Addr 
Protect 


Result =0 

1 Result j^0 


Exclusive OR 


XR 


17 


RR 


Rl, R2 


Exclusive-OR opr 2 and opr 1 and 
modulo-two sum placed in opr 1 . 




Result =0 

1 Result /0 


Exclusive OR 
Immediate 


XI 


97 


SI 


D1(B1), 12 


Exclusive-OR opr 2 and opr 1 and 
modulo-two sum placed in opr 1 . 


Addr 
Protect 


Result =0 

1 Result /l 


Execute 


EX 


44 


RX 


Rl, D2(X2,B2) 


The instruction addressed by opr 2 
is modified by opr 1 and executed. 


Addr 
Exec 
Specif 


May be 
set by this 
instruction 


Halve, Long 


HDR 


24 


RR 


Rl, R2 


Opr 2 is divided by 2 and placed in 
opr 1 . 


Specif 
Opera 


Unchanged 


Halve, Short 


HER 


34 


RR 


Rl, R2 


Opr 2 is divided by 2 and placed in 
opr 1 . 


Opera 


Unchanged 


Halt Device 


HDV 


9E01 


S 


D1(B1) 


Execution of current I/O op at 

addressed dev is terminated 

(full oped- 1001 lllOxxxxxxxl). 


Priv 


Subchan busy with another 

dev or int pending 
, 1 CSW stored 
2 Chan working with 

another device 


Halt I/O 


HIO 


9E00 


S 


D1(B1) 


Execution of current I/O op at 
addresses dev, subchan, and chan term 
(full op cd - 1001 1110 xxxx xxxO). 


Priv 


Chan or sub- 
chan not working 

1 CSW stored 

2 Burst oper 
terminated 

3 Not operational 


Insert Character 


IC 


43 


RX 


Rl, D2(X2,B2) 


Byte at opr 2 is inserted in low 
order byte of reg at opr 1 . 


Addr 


Unchanged 


Insert Characters 
Under Mask 


ICM 


BF 


RS 


Rl, M3,D2(B2) 


1 to 4 bytes at opr 2 are inserted 
in reg at opr 1 under control of 
mask. 


Addr 

Protect 

Opera 


Selected bits or mask* , 

1 Leftmost bit of spec byte = l 

2 Leftmost bit of spec byte=0 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Insert PSW Key 


IPK 


B208 


S 




Protection key of current PSW inserted into 
reg 2 bit pos 24-27. Bits 28-31 set to 0. 


Priv 


Unchanged 


Insert Storage Key 


ISK 


09 


RR 


Rl, R2 


Opr 2, 8-20 fetches 7-bit sto key byte. 
7-bit sto key is placed in opr 1, 24-30. 
Bits 0-23 unchanged, 31 set to zero, 
(opr 2, 0-7 and 21-27 ignored, 28-31 
must = 0) 


Priv 
Addr 
Specif 
Opera 


Unchanged 


Load 


L 


58 


RX 


Rl, D2(X2,B2) 


Load opr 2 into opr 1 . 


Addr 
Specif 


Unchanged 


Load 


LR 


18 


RR 


Rl, R2 


Opr 2 into opr 1 . 


None 


Unchanged 


Load Address 


LA 


41 


RX 


Rl, D2(X2,B2) 


Opr 2, 12-31 to opr 1, 8-31. 
Opr 1, 0-7 set to zero 
(no storage reference made) 


None 


Unchanged 


Load and Test 


LTR 


12 


RR 


Rl, R2 


Opr 2 into opr 1 

(When opr 1 and opr 2 specify same reg 

result is test without data transfer.) 


None 


Result = 

1 Result < 

2 Result > 


Load and Test (Long) 


LTDR 


22 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 
(When opr 1 and opr 2 specify same reg 
result is test without data transfer.) 


Specif 
Opera 


Result fraction = 

1 Result < 

2 Result > 


Load and Test (Short) 


LTER 


32 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 
(Low-order half of opr 1 unchanged) 
(When opr 1 and opr 2 specify same reg 
result is test without data transfer.) 


Specif 
Opera 


Result Fraction = 

1 Result < 

2 Result > 


Load Complement 


LCR 


13 


RR 


Rl, R2 


2's complement of opr 2 into opr 1 
(overflow when max negative number is 
complemented) 


Fxpt Oflo 


Result = Expt Uflo 

1 Result < 

2 Result > 

3 Overflow 





Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 




Load Complement 
(Short) 


LCER 


33 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 

(Opr 1 sign inverted, low-order half 

unchanged) 

(Opr 2 unchanged) 


Specif 
Opera 


Result 
Fract = 

1 Result<0 

2 Result>0 




Load Complement 
(Long) 


LCDR 


23 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 

(Opr 1 sign inverted, low-order half 

unchanged) 

(Opr 2 unchanged) 

(Low-order half of opr 1 unchanged) 


Specif 
Opera 


Result 
Fract = 

1 Result<0 

2 Result>0 


) 


Load Control 


LCTL 


B7 


RS 


Rl, R3,D2(B2) 


Cntl regs from opr 1 to opr 3 
loaded with info starting at 
opr 2. 


Addr 

Specif 

Priv 

Protect 

Opera 


Unchanged 




Load Halfword 


LH 


48 


RX 


Rl, D2(X2,B2) 


Opr 2 halfword expanded to full word 
with sign bits, placed in opr 1 
(High-order expanded) 


Addr 
Specif 


Unchanged 




Load (Long) 


LD 


68 


RX 


Rl, D2(X2,B2) 


Opr 2 into opr 1 
(Sto) (FPR) 


Addr 

Specif 

Opera 


Unchanged 




Load (Long) 


LDR 


28 


RR 


Rl, R2 


Opr 2 into opr 1 
(FPR) (FPR) 


Specif 
Opera 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Load Multiple 


LM 


98 


RS 


Rl, R3, D2(B2) 


Opr 2 into GPRs in ascending order 
Starting reg specified by opr 1 , ending 
reg specified by opr 3 
(Reg wrap-around possible) 


Addr 
Specif 


Unchanged 


Load Negative 


LNR 


11 


RR 


Rl, R2 


2's complement of opr 2 into opr 1 

(Reg) (Reg) 
(If opr 2 contains a (-) number or zero, 
the number is unchanged) 


None 


Result = 

1 Result < 


Load Negative 
(Long) 


LNDR 


21 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 

Opr 1 sign bit is 1 (negative) 

Opr 2 unchanged 


Specif 
Opera 


Result 
Fract = 

1 Result <0 


Load Negative 
(Short) 


LNER 


31 


RR 


Rl, R2 


Opr 2 into opr 1 

Opr 1 sign bit is 1 (negative) 

Opr 2 unchanged 

(Low-order half of opr 1 unchanged) 


Specif 
Opera 


Result 
Fract = 

1 Result<0 


Load Positive 


LPR 


10 


RR 


Rl, R2 


Opr 2 into opr 1 

(Negative numbers are complemented) 
(Overflow occurs when the max negative 
number is complemented) 


Fxpt Oflo 


Result = 

2 Result >0 

3 Overflow 


Load Positive 
(Long) 


LPDR 


20 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 

Opr 1 sign bit made a zero (positive) 

Opr 2 unchanged 


Specif 
Opera 


Result 
Fract = 

1 Result <0 

2 Result >0 


Load Positive 
(Short) 


LPER 


30 


RR 


Rl, R2 


Opr 2 into opr 1 

Opr 1 sign bit made a zero (positive) 

Opr 2 unchanged 

(Low-order half of opr 1 unchanged) 


Specif 
Opera 


Result 
Fract = 

1 Result <0 

2 Result >0 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Load PSW 


LPSW 


82 


SI 


Dl (Bl) 


Opr 1 into PSW 

(Opr 1 low-order 3 bit adr must = 0) 
(Instruction used to enter the problem or 
wait state) 


Priv 
Addr 
Specif 


Set according to 
new PSW bits 
34 and 35 


Load (Short) 


LE 


78 


RX 


R1,D2(X2,B2) 


Opr 2 into opr 1 

(Sto) (FPR) 

(Low-crder half of opr 1 unchanged) 


Addr 

Specif 

Opera 


Unchanged 


Load (Short) 


LER 


38 


RR 


Rl, R2 


Opr 2 into opr 1 

(FPR) (FPR) 

(Low-order half of opr 1 unchanged) 


Specif 
Opera 


Unchanged 


Load Real Address 


LRA 


Bl 


RX 


R1,D2(X2,B2) 


Real adr corresponding to opr 2 logical 
adr placed in opr 1 . 


Priv 
Addr 
Specif 
Opera 


Translation 
available 

1 Seg tbl entry 
invalid 

2 Page tbl entry 
invalid 

3 Seg or page tbl 
length violation 


Load Rounded 
(Extended to Long) 


LRDR 


25 


RR 


Rl, R2 


Opr 2 is rounded from extended to long 

format and put in opr 1 

(FPR pair) (FPR) 

Only FPR and FPR 4 may be specified 

for opr 2. 


Specif 
Exp Oflo 
Opera 


Unchanged 


Load Rounded 
(Long to Short) 


LRER 


35 


RR 


Rl, R2 


Opr 2 is rounded from long to short format 
and put into opr 1 
(FPR) (FPR) 

Add an absolute 1 to opr 2, bit 32; carry 
will ripple left. 

Lower half of result FPR will remain un- 
changed. 


Specif 
Exp Oflo 
Opera 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Monitor Call 


MC 


AF 


SI 


Dl (B1),I2 


Causes program interrupt if monitor- 
mask bit in cont. reg 8 = appropriate 
monitor class specified in positions 
12-15 of 12. Real storage locations 148 
and 156 will zero, loc 149=12, and loc. 
157-159=D1 + contents to Bl . 


Monitor 
Specif 


Unchanged 


Move Characters 


MVC 


D2 


SS 


01(1,80,02(82) 


Opr 2 to opr 1 

(Left to right byte by byte) 

(Max number of bytes moved: 256) 

(No restriction on overlapping fields) 


Addr 
Protect 


Unchanged 


Move Immediate 


MVI 


92 


SI 


D1(B1), 12 


Move the 1 byte from the instruction stream 
(8-15) to opr 1. 


Addr 
Protect 


Unchanged 


Move Long 


MVCL 


*0E 


RR 


Rl, R2 


Move char from area spec in opr 2 to area 
spec in opr 1 . Opr 2 is even/odd reg pair 
where R2 is "from adr", R2+1 bits 0-7 is 
padding char, and R2+1 bits 8-31 is length. 
Opr 1 is even/odd reg. pair 
where Rl is "to" addr, Rl+1 
bits 8-31 is length. 


Addr 
Specif 


Opr cnts = 

1 Opr 1 cnt< 
opr 2 cnt 

2 Opr 1 cnt> 
opr 2 cnt 

3 No move due 
to destructive 
overlap. 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Move Numerics 


MVN 


Dl 


SS 


D1(L,B1), D2(B2) 


The 4 low-order bits of opr 2 bytes into the 

4 low-order bits of opr 1 bytes. 

(Left to right byte by byte) 

(Max number of bytes moved: 256) 

(High-order bits of each byte of both opr's 

unchanged.) 

(No restriction on overlapping fields.) 


Addr 
Protect 


Unchanged 


Move with Offset 


MVO 


Fl 


SS 


Dl (L1,B1), D2 
(L2,B2) 


Opr 2 to the left of and adjacent to the 

low-order 4 bits of opr 1 . 

(Right to left byte by byte) 

(Data can be packed, unpacked, or binary 

format) 

(No restriction on overlapping fields) 

(Processing terminated by high-order bit 

in opr 1) 

(If opr 2 field shorter than opr 1 , insert 

leading zeros in opr 2.) 


Addr 
Protect 


Unchanged 


Move Zones 


MVZ 


D3 


SS 


D1(L,B1), D2(B2) 


The 4 high-order bits of opr 2 bytes into the 

4 high-order bits of opr 1 bytes 

(Left to right byte by byte) 

(Max number of bytes moved: 256) 

(Low-order bits of each byte of both opr's 

unchanged.) 

(No restriction on overlapping fields) 


Addr 
Protect 


Unchanged 


Multiply 


M 


5C 


RX 


Rl, D2(X2,B2) 


Multiply opr 1 by opr 2 

Product: even and odd pair regs 

Opr 1 becomes the product. 

(Opr 1 must specify an even-numbered reg) 

(Sign bit extended to 1st significant product 

digit) 


Addr 
Specif 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Multiply 


MR 


1C 


RR 


Rl, R2 


Multiply opr 1 by opr 2 

Product: even and odd pair of regs 

Opr 1 becomes the product. 

(Opr 1 must specify an even-numbered reg) 

(Sign bit extended to 1st significant product 

digit) 


Specif 


Unchanged 


Multiply (Extended) 


MXR 


26 


RR 


Rl, R2 


Multiply extended opr 1 by extended opr 2 
(FPRpair) (FPR pair) 
Extended product is put in opr 1 (FPR pair) 
(Only FPR and FPR 4 may be specified for 
either opr 1 or opr 2) 
(Low-order characteristic is made 14 < 
high-order characteristic except when the 
result would be> 0, then the low-order 
characteristic is made 1 28 > its correct 
value; sign of low-order characteristic re- 
mains the same as high-order characteris- 
tic) 


Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 


Multiply Decimal 


MP 


FC 


SS 


D1(L1,B1), 
D2(L2,B2) 


Multiply opr 1 by opr 2 

Multiplier: 8 bytes max size and shorter 

than the multiplicand. 

Multiplicand: must have high-order zeros 

equal to or greater than the size of the 

multiplier. 

(Both opr's in packed format) 

(Right to left byte by byte) 

Product: must contain at least 1 high-order 

zero. 


Addr 

Specif 

Data 

Protect 

Opera 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Multiply Halfword 


MH 


4C 


RX 


Rl, D2(X2,B2) 


Multiply opr 1 by opr 2 
(Opr 2 is expanded to a 32-bit integer) 
(Only the low-order 32 bits of the product 
opr 1 , are retained) 


Addr 
Specif 


Unchanged 


Multiply (Long) 


MD 


6C 


RX 


Rl, D2(X2,B2) 


Multiply opr 1 by opr 2 

(FPR) (Sto) 
Product: prenormalizes the opr's and post- 
normalizes the intermediate product. 
(If all fraction digits (15) = zero; the 
product, sign and char are made zero.) 
(The intermediate product fraction is 
truncated before left-shifting.) 


Addr 
Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 


Multiply (Long) 


MDR 


2C 


RR 


Rl, R2 


Multiply opr 1 by opr 2 
(FPR) (FPR) 
Product: prenormalizes the opr's and post- 
normalizes the intermediate product. 
(If all fraction digits (15) = 0; the product 
sign and char are made zero.) 
(The intermediate product fraction is 
truncated before left-shifting.) 


Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 


Multiply (Long to 
Extended) 


MXD 


67 


RX 


Rl, D2(X2,B2) 


Multiply long opr 1 by long opr 2. 

(FPR) (Sto) 
Extended product is put in FPR pair speci- 
fied by opr 1 

(Only FPR and FPR 4 may be specified 
for opr 1 ) 

(Signs of FPR pair are the same) 
(Can only use doubleword boundary in stor 
age) 
(Continued) 


Addr 
Specif 
Exp Oflo, 
Exp Uflo 
Protect 
Opera 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Multiply (Long to 
Extended) (Cont'd) 


MXD 


67 


RX 


Rl, D2(X2,B2) 


(Low-order characteristic is made 14< 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128 >its correct 
value; sign of low-order characteristic 
remains the same as high-order character- 
istics) 






Multiply (Long to 
Extended) 


MXDR 


27 


RR 


Rl, R2 


Multiply long opr 1 by long opr 2. 

(FPR) (FPR) 
Extended product is put in FPR pair 
specified by opr 1 

(Only FPR and FPR 4 may be specified 
for opr 1 ) 

(Signs of FPR pair are the same) 
(Low-order characteristic is made 14 < 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128> its correct 
value; sign of low-order characteristic 
remains the same as the high-order charac- 
teristic) 


Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 


Multiply (Short) 


ME 


7C 


RX 


Rl, D2(X2,B2) 


Multiply opr 1 by opr 2 
(FPR) (Sto) 
Product: prenormalizes the opr's and post- 
normalizes the intermediate product. 
(If all fraction digits (14) = 0; the product 
sign and char are made zero.) 
(The intermediate product fraction is trun- 
cated before left-shifting.) 
(The 2 low-order fraction digits of the 
product always = zero.) 


Addr 
Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Multiply (Short) 


MER 


3C 


RR 


Rl, R2 


Multiply opr 1 by opr 2 
(FPR) (FPR) 

Product: prenormalizes the opr's and post- 
normalizes the intermediate product. 
(If all fraction digits (14) = 0; the product 
sign and char are made zero.) 
(The intermediate product fraction is trun- 
cated before left-shifting.) 


Specif 
Exp Oflo 
Exp Uflo 
Opera 


Unchanged 


No Operation 


NOP 


47(BC 0) 


RX, 
Ext. 


D2(X2,B2) 


Comp mask with cond code 


None 


Unchanged 


No Operation 


NOPR 


07(BCR 0) 


RR, 
Ext. 


R2 


Comp mask with cond code 


None 


Unchanged 


OR Logical 





56 


RX 


Rl, D2(X2,B2) 


The ORed sum of both opr's into opr 1 


Addr 
Specif 


Result = 

1 Result /0 


OR Logical 


OC 


D6 


SS 


D1(L,B1),D2(B2) 


The ORed sum of both opr's into opr 1 
(Left to right byte by byte) 
(Max number of bytes ORed: 256) 


Addr 
Protect 


Result = 

1 Result /0 


OR Logical 


OR 


16 


RR 


Rl, R2 


The ORed sum of both opr's into opr 1 


None 


Result = 

1 Result ^0 


OR Logical 
Immediate 


Ol 


96 


SI 


D1(B1),|2 


OR the 1 byte from the instruction stream 
(8-15) to opr 1 


Addr 
Protect 


Result = 

1 Result ^0 


Pack 


PACK 


F2 


SS 


D1(L1,B1), 
D2(L2,B2) 


Change opr 2 from zoned to packed format 

and place into opr 1 . 

(Right to left byte by byte) 

(No restriction on overlapping fields) 

(Opr 2 may be extended with hi-order zeros) 


Addr 
Protect 


Unchanged 


Purge Translation 
Lookaside Buffer 


PTLB 


B20D 


S 


— 


Invalidate current info in TLB. 


Priv 
Opera 


Unchanged 



Ext. - Extended Mnemonic 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Read Direct 


RDD 


85 


SI 


D1(B1), 12 


The 1 byte from the instruction stream 
(8-15) is placed on the signal-out, in a 
form of 8 timing pulses, along with a 9th 
pulse at the read-out line. The 8 bit lines 
at the direct-in lines are stored in or 1 . 


Priv 
Addr 
Protect 
Opera 


Unchanged 


Reset Reference 
Bit 


RRB 


B213 


S 


D1(B1) 


Set refence-bit=0 for 2048 byte block 
referenced by opr 1. CC indicates setting 
of ref and change bits prior to exec of this 
instruction. 


Priv 
Opera 


Ref = 
Chg = 

1 Ref = 
Chg=l 

2 Ref = 1 
Chg = 

3 Ref = 1 
Chg= 1 


Set Clock 


SCK 


B204 


S 


D1(B1) 


Replace curr val of TOD clock with eight 
bytes starting at opr 1 . 


Addr 

Specif 

Priv 

Protect 

Opera 


Clock val set 

1 Clock val secure 

2 — 

3 Clock not oper 


Set Clock Compar- 
ator 


SCKC 


B206 


S 


D1(B1) 


Dblwd at opr 1 replaces curr value of clock 
comparator 


Addr 

Priv 

Specif 

Protect 

Opera 


Unchanged 


Set CPU Timer 


SPT 


B208 


S 


D1(B1) 


Dblwd at opr 1 replaces curr value of CPU 
timer. 


Addr 

Priv 

Specif 

Protect 

Opera 


Unchanged 


Set Prefix 


SPX 


B210 


S 


D2(B2) 


Prefix reg contents replaced by contents of 
bit pos 8- 19 of word located by opr 2 
address. 


Specif 
Opera 
Priv 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Set Program Mask 


SPM 


04 


RR 


Rl 


Opr 1 (2-7) replaces the cond code and 
program mask bits of the current PSW 
(34-39) (Bits 0, 1 and 8-31 of opr. 1 are 
ignored and unchanged.) 


None 


Set by bits 
2 and 3 


Set PSW Key 
From Address 


SPKA 


B20A 


S 


D1(B1) 


Protection key of PSW replaced by bits 
24-27 of the opr address. 


Opera 
Priv 


Unchanged 


Set Storage Key 


SSK 


08 


RR 


Rl, R2 


Opr 1 (24-30) replaces the storage key 
specified by opr 2 

(Opr 1 bits 0-23 and 31 are ignored) 
(Opr 2 bits 0-7 and 21-27 are ignored) 
(Bits 28-31 must be zero) 


Addr 
Priv 
Specif 
Opera 


Unchanged 


Set System Mask 


SSM 


80 


S 


D1(B1) 


Opr 1 (1 byte) replaces the system mask 
bits of the current PSW (0-7). 


Priv 
Addr 


Unchanged 


Shift and Round 
Decimal 


SRP 


F0 


SS 


D1(L1,B1), 
D2(B2), 13 


Shift opr 1 as specified by opr 2. If shift 
is right, round by factor in opr 3. 


Protect 
Opera 
Addr 
Data 
Dec Oflo 


Result = 

1 Result < 

2 Result > 

3 Result Oflo 


Shift Left Double 
Algebraic 


SLDA 


8F 


RS 


Rl, D2(B2) 


Opr 1 (even and odd regs) is shifted left 
the number of times equal to opr 2 (low- 
order 6 bits). 


Specif 
Fxpt Oflo 


Result = 

1 Result < 

2 Result > 

3 Overflow 


Shift Left Double 
Logical 


SLDL 


8D 


RS 


Rl, D2(B2) 


Opr 1 (even and odd regs) is shifted left 
the number of times equal to opr 2 (low- 
order 6 bits). 
(Hi-order bit participates in the shift) 


Specif 


Unchanged 


Shift Left Single 
Algebraic 


SLA 


8B 


RS 


Rl, D2(B2) 


Opr 1 is shifted left the number of times 
equal to opr 2 (low-order 6 bits). 


Fxpt Oflo 


Result = 

1 Result < 

2 Result > 

3 Overflow 



o 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Shift Left Single 


SLL 


89 


RS 


Rl, D2(B2) 


Opr 1 is shifted left the number of times 


None 


Unchanged 


Logical 










equal to opr 2 (low-order 6 bits). 
(Hi-order bit participates in the shift) 






Shift Right Double 


SRDA 


8E 


RS 


Rl, D2(B2) 


Opr 1 (even and odd regs) is shifted right 


Specif 


Result = 


Algebraic 










the number of times equal to opr 2 
(Low-order 6 bits). 




1 Result < 

2 Result >0 


Shift Right Double 


SRDL 


8C 


RS 


Rl, D2(B2) 


Opr 1 (even and odd regs) is shifted right 


Specif 


Unchanged 


Logical 










the number of times equal to opr 2 

(low-order 6 bits). 

(Hi-order bit participates in the shift) 






Shift Right Single 


SRA 


8A 


RS 


Rl, D2(B2) 


Opr 1 is shifted right the number of times 


None 


Result = 


Algebraic 










equal to opr 2 (low-order 6 bits). 
(Shifting (+) numbers: vacated bits are 
replaced with zeros.) 
(Shifting (-) numbers: vacated bits are 
replaced with ones.) 




1 Result <0 

2 Result >0 


Shift Righl Single 


SRL 


88 


RS 


Rl, D2(B2) 


Opr 1 is shifted right the number of times 


None 


Unchanged 


Logical 










equal to opr 2 (low-order 6 bits). 
(Vacated bits are replaced with zeros) 
(Hi-order bit participates in the shift) 






Signal Processor 


SIGP 


AE 


RS 


Rl, R3, D2(B2) 


An eight-bit order code (bits 24-31 of the 
second-operand address) is transmitted to 
the CPU designated by the processor 
address (bits 16-31) in the third operand. 


Priv 


= Order code 

accepted 

1 = Status stored 

2 = Channel or 

subchannel 

3 = Channel not 

operational 


Start I/O 


SIO 


9C00 


S 


D1(B1) 


Opr 1 (16-31) identifies the selected chan, 
ctl unit and I/O device to perform write, 


Priv 


= I/O oper 














initiated and 












read, read bkwd, control or sense oper. 




chan pro- 












The CAW at loc 48 is fetched, which 




ceeding with 












locates the first CCW. 




operation. 












The SIO is initiated providing the addressed 
chan, ctl unit and l/O device are available 




1 = CSW stored 














2 = Chan or sub- 












without pending interrupt errors. 




channel busy 












Exceptional conditions pending 




3 = Not opera- 












(Full op <d- 1001 HOOxxxxxxxO) 




tional 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Good Code 


Start I/O Fast 
Release 


SIOF 


9C01 


S 


01(31) 


This instruction takes advantage of the 
block-multiplex channel, but is otherwise 
identical to SIO. (Full op cd - 1001 
HOOxxxxxxxl). 


Priv 


Same cs SIO 


Store 


ST 


50 


RX 


Rl, D2(X2,B2) 


Opr 1 is stored into opr 2. 


Addr 

Specif 

Protect 


Unchanged 


Store Channel ID 


STIDC 


B203 


S 


D1(B1) 


Store opr 1 at loc 168 in main storage. 


Priv 
Opera 


ID stored 

1 CSW stored 

2 Chan activity 
ID not stored 

3 Not oper. 


Store Character 


STC 


42 


RX 


Rl, D2(X2,B2) 


Opr 1 (24-31) replaces the character at opr 
2's address. 


Addr 
Protect 


Unchanged 


Store Characters 
Under Mask 


STCM 


BE 


RS 


Rl , M3, D2(B2) 


Bytes selected from opr 1 under control of 
mask are stored at opr 2. 


Addr 

Opera 

Protect 


Unchanged 


Store Clock 


STCK 


B205 


S 


D1(B1) 


Current val of TOD clock stored in 8 bytes 
at opr 1 . 


Addr 

Protect 

Opera 


Clock in sot 
statj 

1 Clk in not-tei 
state 

2 Clk in error 

3 Clk not oper 
or in stopped 
state 


Store Clock 
Comparator 


STCKC 


B207 


S 


D1(B1) 


Curr contents of clock comparator stored at 


Addr 

Priv 

Specif 

Protect 

Opera 


Unchanged 



o 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Store Control 


STCTL 


B6 


RS 


Rl, R3, D2(B2) 


Control regs from opr 1 to opr 3 stored at 
opr 2. 


Priv 

Addr 

Specif 

Protect 

Opera 


Unchanged 


Store CPU Address 


STAP 


B212 


S 


D2(B2) 


CPU address stored at halfword location 
designated by second-operand address. 


Specif 
Opera 
Priv 


Unchanged 


Store CPU ID 


STIDP 


B202 


S 


D1(B1) 


CPU info stored in 8 bytes at oprl . 


Priv 

Addr 

Specif 

Protect 

Opera 


Unchanged 


Store CPU Timer 


STPT 


B209 


S 


D1(B1) 


Curr contents of CPU timer stored in 
dblwd at opr 1 . 


Priv 

Addr 

Specif 

Protect 

Opera 


Unchanged 


Store Halfword 


STH 


40 


RX 


Rl, D2(X2,B2) 


Opr 1 (16 low-order bits) is stored at 
opr 2's location. 

(Hi-order bits, opr 1, ignored and un- 
changed) 


Addr 

Specif 

Protect 


Unchanged 


Store (Long) 


STD 


60 


RX 


Rl, D2(X2,B2) 


FP opr 1 to opr 2's location. 


Addr 
Protect 
Specif 
Opera 


Unchanged 


Store Multiple 


STM 


90 


RS 


Rl, R2, D2(B2) 


Opr 1 thru opr 3 are stored at opr 2's 
location in ascending order. Starting reg 
specified by opr 1, ending reg specified by 
opr 3. 
(Reg wrap-around possible) 


Addr 

Specif 

Protect 


Unchanged 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Store Prefix 


STPX 


B211 


S 


D2(B2) 


Prefix register contents are stored at word 
location designated by second operand 
address. 


Specif 
Opera 
Prlv' 


Unchanged 


Store (Short) 


STE 


70 


RX 


Rl, D2(X2,B2) 


FP opr 1 is stored at opr 2's location 
(Low-order half of FPR ignored and un- 
changed) 


Opera 
Addr 
Specif 
Protect 


Unchanged 


Store Then AND 
System Mask 


STNSM 


AC 


SI 


DI(B1),I2 


Bits 0-7 current PSW stored at opr 1, then 
these bits ANDed with opr 2 and replaced 
in current PSW. 


Addr 
Priv 
Protect 
Opera 


Unchanged 


Store Then OR 
System Mask 


STOSM 


AD 


SI 


D1(B1), 12 


Bits 0-7 of current PSW stored at opr 1 , 
then these bits ORed with opr 2 and 
replaced in current PSW. 


Addr 
Priv 
Protect 
Opera 


Unchanged 


Subtract 


S 


5B 


RX 


Rl, D2(X2) 


Subtract opr 2 from opr 1 and place the . 
difference into opr 1 . 


Addr 

Fxpt Oflo 
Specif 


0Dif = 
1 Dif<0 
2Dif>0 
3 Overflow 


Subtract 


SR 


IB 


RR 


Rl, R2 


Subtract opr 2 from opr 1; difference 
placed into opr 1 . 


Fxpt Oflo 


ODif = 

1 Dif<0 

2 Dif>0 

3 Overflow 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Subtract Decimal 


SP 


FB 


SS 


D1(L1,B1), D2(L2,B2) 


Subtract dec opr 2 from opr 1; 
difference stored into opr 1 . 
(Right to left byte by byte) (Both opr's must 
be in packed format) (Fields can overlap if 
low-order bytes coincide) 


Opera 
Addr 
Data 

Dec Oflo 
Protect 


Dif = 

1 Dif<0 

2 Dif>0 

3 Overflow 


Subtract Halfword 


SH 


4B 


RX 


Rl, D2(X2 ; B2) 


Opr 2 hplfword expanded to fullword and 
subtracted from opr 1; difference placed 
into opr 1 . 


Addr 

Fxpt Oflo 
Specif 


Dif = 

1 Dif<0 

2 Dif>0 

3 Overflow 


Subtract Logical 


SL 


5F 


RX 


Rl, D2(X2,B2) 


Subtract opr 2 from opr 1; 
difference placed into opr 1 . 


Addr 
Specif 


— 

1 Dif^O 
No Carry 

2 Dif = 
Carry 

3 Dif ^ 
Carry 


Subtract Logical 


SLR 


IF 


RR 


Rl, R2 


Subtract opr 2 from opr 1; 
difference placed into opr 1 . 


None 


0~ 

1 Dif^O 
No Carry 

2 Dif = 
Carry 

3 Dif ^ 
Carry 


Subtract Normalized 


SXR 


37 


RR 


Rl, R2 


FP subtract extended opr 2 from extended 




Fract = 


(Extended) 










opr 1. 

(FPR pair) (FPR pair) 
Extended difference is put in opr 1 (FPR 
pair) (Sign of extended opr 2 is inverted 
before the addition) 
(Only FPR and FPR 4 may be specified 
for either opr 1 or opr 2) 
(Continued) 


Specif 
Exp Oflo 
Exp Uflo 
Signif 


1 Fract < 

2 Fract >0 
3-- 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Subtract Normalized 
(Extended) (Cont'd) 


SXR 


37 


RR 


Rl, R2 


(High-order and low-order signs of a FPR 
pair are always the same in extended 
precision) 

(Low-order characteristic is made 14 < 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128 > its correct 
value; sign of low-order characteristic 
remains the same as high-order charac- 
teristic) 






Subtract Normalized 
(Long) 


SD 


6B 


RX 


R1, D2(X2,B2) 


FP Subtract opr 2 from opr 1 and the 

difference placed into opr 1. 

(The sign of opr 2 is inverted before the 

addition.) 


Addr 
Specif 
Signif 
Exp Oflo 
Exp Uflo 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 


Subtract Normalized 
(Long) 


SDR 


2B 


RR 


Rl, R2 


FP Subtract opr 2 from opr 1 

(FPR) (FPR) 
(The sign of opr 2 is inverted before the 
addition.) 


Specif 
Signif 
Exp Oflo 
Exp Uflo 


Result 

Fract = 

1 Result<0 

2 Result > 

3 Exp Oflo 


Subtract Normalized 
(Short) 


SE 


7B 


RX 


Rl, D2(X2,B2) 


FP Subtract opr 2 from opr 1 

(The sign of opr 2 is inverted before the 

addition.) 

(Low-order halves of FPR ignored and 

unchanged). 


Addr 
Specif 
Signif 
Exp Oflo 
Exp Uflo 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Subtract Normalized 
(Short) 


SER 


3B 


RR 


Rl, R2 


Subtract opr 2 from opr 1 

(The sign of opr 2 is inverted before the 

addition.) 

(Low-order halves of FPRs ignored and 

unchanged) 


Specif 
Signif 
Exp Oflo 
Exp Uflo 


Result 

Fract =0 

1 Result < 

2 Result > 

3 Exp Oflo 


Subtract 
Unnormalized (Long) 


SW 


6F 


RX 


Rl, D2(X2,B2) 


FP Subtract opr 2 from opr 1 
(Sto) (FPR) 
(The sign of opr 2 is inverted before the 
addition.) 


Addr 
Specif 
Signif 
Exp Oflo 
Opera 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 


Subtract 
Unnormalized (Long) 


SWR 


2F 


RR 


Rl, R2 


FP Subtract opr 2 from opr 1 

(FPR) (FPR) 
(The sign of opr 2 is inverted before the 
addition.) 


Specif 
Signif 
Exp Oflo 
Opera 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 


Subtract 
Unnormalized (Short) 


su 


7F 


RX 


Rl, D2(X2,B2) 


FP Subtract opr 2 from opr 1 

(Sto) (FPR) 
(Low-order half of FPR ignored and 
unchanged) 

(The sign of opr 2 is inverted before the 
addition.) 


Addr 
Specif 
Signif 
Exp Oflo 
Opera 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 


Subtract 
Unnormalized (Short) 


SUR 


3F 


RR 


Rl, R2 


FP Subtract opr 2 from opr 1 

(FPR) (FPR) 
(Low-order halves of FPRs ignored and 
unchanged) 

(The sign of opr 2 is inverted before the 
addition.) 


Specif 
Signif 
Exp Oflo 
Opera 


Result 

Fract = 

1 Result < 

2 Result > 

3 Exp Oflo 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Supervisor Call 


SVC 


OA 


RR 


1 


Immediate bits (8-15) placed in loc. 138 
and PSW swap performed . 
(16-23) are made zero. 
(Old PSW at loc 32). 
(New PSW from loc 96). 


None 


Unchanged 


Test and Set 


TS 


93 


SI 


Dl (Bl ) 


Hi-order bit of 1st byte of opr adr sets 

cond code. 

Entire byte then set to 1 's 


Addr 
Protect 


Hi -order 
bit =0 

1 Hi-order 
bit = 1 

2 — 

3 — 


Test Channel 


TCH 


9F 


S 


D1(B1) 


Opr 1 (16-23) identifies the tested channel. 
(Bits 24-31 are ignored.) 
(Instruction checks the channel's status 
and sets appropriate cond code.) 


Priv 


Chan AvI 

1 Int Pending 

2 Chan in 
Burst Mode 

3 Chan not 
Operational 


Test I/O 


TIO 


9D 


S 


Dl (Bl ) 


Opr 1 (16-31) identifies the tested channel, 
control unit, and I/O device. Used to clear 
a pending interrupt. 
(CSW stored at loc 64): 
Subchannel contains a pending interrupt. 
I/O device contains a pending interrupt. 
Control unit or I/O device is executing a 
previous operation or a pending chan- 
nel-end/control unit-end for another 
I/O device. 
Channel or I/O device equipment error or 
device not ready. 


Priv 


Available 

1 CSW 
Stored 

2 Channel or 
Subchan 
Busy 

3 Not 
Operational 



o 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Test Under 
Mask 


TM 


91 


SI 


D1(B1), 12 


Immediate bits (8-15) used as a mask to 

compare against opr I. 

Mask bit 1: storage bit tested. 

Mask bit 0: storage bit ignored- 


Addr 


Selected 
bits all 
zero (mask 
is all zero) 

1 Selected 
bits mixed 
0's and 1 's 

3 Selected 
bits all 1's 


Translate 


TR 


DC 


SS 


D1(L,B1), D2(B2) 


Opr 1 (argument byte) added to the initial 

adr of opr 2 (24-31). This adr now is the 

loc of the function byte which replaces the 

original argument byte (left to right byte 

by byte) 

(All data is valid) 

(Oper is terminated when opr 1 field is 

exhausted) 


Addr 
Protect 


Unchanged 


Translate 
and Test 


TRT 


DD 


SS 


D1(L,B1), D2(B2) 


(Same as TR) Addr 

When the function byte is a zero the next 

argument byte is translated. Both opr's 

remain unchanged. When the function byte 

is a non-zero the operation ijs completed. 

The generated argument adr is placed into 

GPR 1 , 8-31 . Bits 0-7 remain unchanged. 

The function byte is placed into GPR 2, 24- 

31 . (Left- to right byte by byte). Bits 0-23 1 

remain unchanged. 

If opr 1 is exhausted before a non-zero cond, 

the opr is completed and GPRs 1 and 2 

remain unchanged. 


OAII 
function 
bytes 

1 Non-0 
function 
byte met 

2 Last 
function 
byte 
non-0 

3 Not used 



Operation 


Mnemonic 


Op Code 


Format 


Operands 


Description 


Exceptions 


Cond Code 


Unpack 


UNPK 


F3 


SS 


D1(L1,B1), D2(L2,B2) 


Change opr 2 from packed to zoned format 

and place into opr 1 . 

(Right to left byte by byte) 

(No restrictions on overlapping fields) 

(Opr 2 may be extended with hi-order zeros.) 


Addr 
Protect 


Unchanged 


Write Direct 


WRD 


84 


SI 


D1(B1), 12 


The 1 byte from the instruction stream 
(8-15) is placed on the timing signal out, 
in a form of 8 timing pulses, along with 
a 9th pulse at the write-out line. 
The 8 bit lines at the direct-out lines are 
brought up by opr 1 . 


Priv 
Addr 
Opera 


Unchanged 


Zero and £dd 


ZAP 


F8 


SS 


Dl 0.1,61), D2(L2,B2) 


Opr 1 cleared and opr 2 placed in opr 1 

(Low-order opr's may coincide) 

(Opr 2 must be in packed format) 

(Opr 1 field must be large enough for all 

opr 2 significant digits) 

(Opr 2 extended with zeros to fill opr 1 .) 


Addr 
Data 

Dec Oflo 
Protect 
Opera 


Result = 

1 Result< 

2 Result > 

3 Overflow 



System Assembler Instructions 



Operation 


Name Entry 


Operand Entry 


ACTR 


A sequence symbol 
or blank 


A SETA expression 


"AGO 


A sequence symbol 
or blank 


A sequence symbol 


AIF 


A sequence symbol 
or blank 


A logical expression enclosed 
in parentheses, immediately 
followed by a sequence symbol 


ANOP 


A sequence symbol 
or blank 


Must not be present 


CCW 


Any symbol or blank 


Four operands, separated by 
commas 


CNOP ^ 


Any symbol or blank 


Two absolute expressions, 
separated by a comma 


COM 


Any symbol or blank 


Must not be present 


COPY 


Must not be present 


One ordinary symbol 


CSECT 


Any symbol or blank 


Must not be present 


CXD 


Any symbol or blank 


Must not be present 


DC 


Any symbol or blank 


One or more operands, separated 
by commas 


DROP 


A sequence symbol 
or blank 


One to sixteen absolute 
expressions, separated by 
commas; or blank 


DS 


Any symbol or blank 


One or more operands, separated 
by commas 


DSECT 


Any symbol or blank 


Must not be present 


DXD 


Any symbol 


One or more operands, separated 
by commas 


EJECT 


A sequence symbol 
or blank 


Must not be present 


END 


A sequence symbol 
or blank 


A relocatable expression or 
blank 


ENTRY 


A sequence symbol 
or blank 


One or more relocatable symbols, 
separated by commas 


EQU 


An ordinary symbol 
or a variable symbol 


One to three operands, 
separated by commas 


EXTRN 


A sequence symbol 
or blank 


One or more relocatable symbols, 
separated by commas 


GBLA 


Must not be present 


One or more variable symbols 
that are to be used as SET symbols, 
separated by commas 


GBLB 


Must not be present 


One or more variable symbols 
that are to be used as SET 
symbols, separated by commas * 



1 -50 OS/VS1 Programmer's Reference Digest 



System Assembler Instructions (cont'd) 



Operation 


Name Entry 


Operand Entry 


GBLC 


Must not be present 


One or more variable symbols 
that are to be used as SET „ 
symbols, separated by commas 


ICTL 


Must not be present 


One to three decimal values, 
separated by commas 


ISEQ 


Must not be present 


Two decimal values, 
separated by commas 


LCLA 


Must not be present 


One or more variable symbols 
that are to be used as SET _ 
symbols, separated by commas 


LCLB 


Must not be present 


One or more variable symbols 
that are to be used as SET 
symbols, separated by commas2 


LCLC 


Must not be present 


One or more variable symbols 
that are to be used as SET 
symbols, separated by commas^ 


LTORG 


Any symbol or blank 


Not required 


MACRO 1 


Must not be present 


Not required 


MEND 1 


A sequence symbol 
or blank 


Not required 


MEXIT 1 


A sequence symbol 
or blank 


Not required 


MNOTE 


A sequence symbol 
or blank 


A severity code followed by a 
comma (this much is optional) 
followed by any combination of 
characters enclosed in 
apostrophes 


OPSYN 


An ordinary symbol 


A machine instruction mnemonic 
code, an extended mnemonic code, 
a macro operation, an assembler 
operation, an operation code 
defined by a previous OPSYN 
instruction, or blank 


ORG 


Any symbol or blank 


A relocatable expression or 
blank 


POP 


A sequence symbol 
or blank 


One or more operands, separated 
by a comma 


PRINT 


A sequence symbol 
or blank 


One to three operands 


PUNCH 


A sequence symbol 
or blank 


One to eighty characters, 
enclosed in apostrophes 


PUSH 


A sequence symbol 
or blank 


One or more operands, separated 
by a comma 


REPRO 


A sequence symbol 
or blank 


Not required 


SETA 


A SETA symbol 


An arithmetic expression 


SETB 


A SETB symbol 


A or a 1 , a SETB symbol, or a 
logical expression enclosed in 
parentheses 



Section 1 : General Information 1-51 



System Assembler Instructions (cont'd) 



Operation 


Name Entry 


Operand Entry 


SETC 


A SETC symbol 


A duplication factor (a SETA 
expression enclosed in parentheses) 
if desired, followed by a type 
attribute, a character expression, 
a substring notation, or a 
concatenation of character 
expressions and substring 
notations 


SPACE 


A sequence symbol 
or blank 


A decimal self-defining 
term or blank 


START 


Any symbol or 
blank 


A self-defining term or blank 


TITLE 


A variable symbol, 
alphameric character 
string, or a combination 
of variable symbol and 
character string, or a 
sequence symbol, or a 
blank. 


One to 100 characters, enclosed 
in apostrophes 


USING 


A sequence symbol 
or blank 


An absolute or relocatable 
expression followed by 1 to 16 
absolute expressions, separated 
by commas 


WXTRN 


A sequence symbol 
or blank 


One or more relocatable 
symbols, separated by commas 



Can be used only as part of a macro definition. 
2 
SET symbols can be defined as subscripted SET symbols. 



1-52 OS/VS1 Programmer's Reference Digest 



System Assembler Statements 



Instruction 


Name Entry 


Operand Entry 


Model Statements 


An ordinary symbol, 


Any combination of char- 




a variable symbol, 


acters (including 




a sequence 


variable symbols) 




symbol, a combina- 






tion of variable 






symbols and other 






characters that is 






equivalent to a 






symbol, or blank 




Prototype Statement' 


A symbolic para- 


Zero or more operands 




meter or blank 


that are symbolic parameters, 
separated by commas 


Macro-lnslruction 
Statement 


An ordinary symbol, 


Zero or more positional 


a variable symbol, 


operands and/or zero 




a sequence symbol, 


or more keyword operands 
separated by commas 




a combination of 




variable symbols 






and other charac- 






ters that is equiv- 
alent to a symbol, 










or blank 




Assembler Language 


An ordinary symbol, 


Any combination of charac- 


Statement 


a variable symbol, 


ters (including variable 




a sequence symbol, 


symbols) 




a combination of 






variable symbols 






and other charac- 






ters that is equiv- 






alent to a symbol, 






or blank 





Can only be used as part of a macro definition. 

variable symbols appearing in a macro instruction are replaced 
by their values before the macro instruction is processed. 



i ; 



Section 1: General Information 1-53 



System Assembler Constants 



TYPE 


IMPLICIT 
LENGTH 
(BYTES) 


ALIGN- 
MENT 


LENGTH 
MODI- 
FIER 
RANGE 


SPECIFIED 
BY 


NUMBER 
OF CON- 
STANTS 
PER 
OPERAND 


RANGE 
FOR EX- 
PONENTS 


RANGE 

FOR 

SCALE 


TRUN- 
CATION/ 
PADDING 
SIDE 


C 


needed 


byte 


256(1) 


characters 


one 






right 


X 


needed 


byfe 


.1 to 
256(1) 


hexadecimal 
digits 


multi- 
ple 






left 


B 


as 


byte 


.1 to 
256 


digits 


pie ' 






left 


F 


4 


word 


.1 to 

8 


decimal 
digits 


multi- 
ple 


-85 to 
+75 


-187 to 
+346 


left (3) 


H 


2 


half 


.1 to 
8 


decimal 
digits 


multi- 
ple 


-85 to 
+75 


-187 
+346 


left (3) 


E 


4 


ward 


.1 to 
8 


decimal 
digits 


multi- 
ple 


-85 to 
+75 


0-14 


right (3) 


D 


8 


double 


.1 to 
8 


decimal 
digits 


multi- 
ple 


-85 to 
+75 


0-14 


right (3) 


L 


16 


word'' 


.1 to 
16 


decimal 
digits 


multi- 
ple 


-85 to 
+75 


0-28 


right (3) 


P 


deeded 


byte • 


.1 to 
16 


decimal 
digits 


pie 






left 


Z 


needed 


byte 


.1 to 
16 


decimal 
digits 


pie 






left 


A 


4 


word 


.1 to 
4(2) 


expression 


multi- 
ple 






left 


Q 


4 


word 


1-4 


symbol nam- 
ing a DXD 
or DSECT 


multi- 
ple 






left 


V 


4 


word 


3, 4 


relocatable 


pie ' 






left 


s 


2 


half 


2 only 


one absolute 

pression or 
two absolute 

exp (exp) 


pie 








Y 


2 


half 


.1 to 
2(2) 


any 
expression 


multi- 
ple 






left 



(1) In a DS assembler instruction C and X type constants can have length specificatioi 

(2) Bit length specification permitted with absolute expressions only. Relocatable A-t 
3 or 4 bytes only; relocatable Y-type constants, 2 bytes only. 

(3) Errors will be flogged if significant bits are truncated or if the value specified car 
tained in the implicit length of the constant. 



-54 OS/VS1 Programmer's Reference Digest 



System Assembler Macro Language Statements 











Vc 


riablo Symbc 


Is 












Attributes 


Sequence 
Symbol 


Requirement 


Symbolic 
Parameter 


Global SET Symbols 


Local SET Symbols 


System Variable Symbols 


SETA 


SETB 


SETC 


SETA 


SETB 


SETC 


&SYSNDX 


&SYSECT 


&SYSLIST 


&SYSPARM 


&SYSDATE 


&SYSTIME 


Type 


Length 


Scaling 


Integer 


Count 


Number 


MACRO 










































Prototype 
Statement 


Name 
Operand 








































GBLA 




Operand 






































GBLB 






Operand 




































GBLC 








Operand 


































LCLA 










Operand 
































LCLB 












Operand 






























LCLC 














Operand 




























Model 
Statement 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Operand 


Operand 














Name 


SETA 


2 
Operand 


Name 
Operand 


3 
Operand 


9 
Operand 


Name 
Operand 


3 
Operand 


Operand 


Operand 




2 
Operand 


9 
Operand 








Operand 


Operand 


Operand 


Operand 


Operand 




SETB 


6 
Operand 


Operand 


Name 
Operand 


6 
Operand 


Operand 


Name 
Operand 


^ ..6 
Operand 


Operand 


4 
Operand 


Operand 6 


Operand 






4 
Operand 


Operand 


Operand 


Operand 


Operand 


Operand 




SETC 


Operand 


Operand 


Operand 


Name 
Operand 


Operand 


Operand 


Name 
Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 














AIF 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


4 
Operand 


Operand 


Operand 






4 
Operand 


Operand 5 


Operand 5 


Operand 


Operand 


Operand 


Name 
Operand 


AGO 








































Name 
Operand 


ACTR 


2 
Operand 


Operand 


3 
Operand 


2 
Operand 


Operand 


3 
Operand 


J- 
Operand 


Operand 




2 
Operand 


2 
Operand 








Operand 


Operand 


Operand 


Operand 


Operand 




ANOP 








































Name 


MEXIT 








































Name 


MNOTE 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 


Operand 














Name 


MEND 








































Name 


Outer 
Macro 




Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 








Name 
Operand 


Operand 


Operand 














Name 


Inner 
Macro 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Name 
Operand 


Operand 


Operand 














Name 


Assembler 
Language 
Statement 




Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


Name 

Operation 

Operand 


























Name 



1 . Variable symbols in macro instructions are replaced'by their values before processing. 

2. Only if value is self-defining term. 

3. Converted to arithmetic +1 or +0. 

4. Only in character relations. 

5. Only in arithmetic relations. 

6. Only in arithmetic or character relations. 

7. Converted to unsigned number. 

8. Converted to character 1 or 0. 

9. Only if one to one decimal digits (from through 2, 147, 483, 647). 



Section 1: General Information 1-55 



System Assembler Conditional Assembly Expressions 



Expression 


Arithmetic Expressions 


Character Expressions 


Logical Expressions 


Can contain 


e Self-defining terms 

• Length, scaling, 
integer, count, and 
number attributes 


• Any combination of 
characters enclosed 
in apostrophes 


• A or a 1 

• SETB symbols 




• SETA and SETB 
symbols 


• Any variable symbol 
enclosed in 
apostrophes 


« Arithmetic 
relations ' 




• SETC symbols whose 
values are a decimal 
self-defining term 


• A concatenation of 
variable symbols and 
other characters 
enclosed in 
apostrophes 


• Character 
relations 

• Arithmetic 




• &SYSPARM if its 
value is a decimal 
self-defining term 








• Symbolic parameters 
if the corresponding 
operand is a decimal 
self-defining term 


• A type attribute 
reference 






• &SYSLIST (n) if the 
corresponding 
operand is a decimal 
self-defining term 








• &SYSLIST(n,m) if 
the corresponding 
operand is a deci- 
mal self-defining 
term 








• &SYSNDX 






Operations 
are 


+, - (unary and bi- 
nary), *, and /; 
parentheses per- 
mitted 


concatenation, with a 
period (.) 


AND, OR, and NOT 
parentheses per- 
mitted 


of values 


-^to^'-l 


through 255 charac- 
ters 


(false) or 

1 (true) 


May be 
used in 


• SETA operands 

• Arithmetic relations' 

• Subscripted SET 
symbols 

• SYSLIST subscript (s) 

• Substring notation 

• Sublist notation 


• SETC operands 

o Character relations 


• SETB operands 

• AIF operands 



An arithmetic relation consists of two arithmetic expressions related by the 
operators GT, LT, EQ, NE, GE, or LE. 
2 

A character relation consists of two character expressions related by tne 
operator GT, LT, EQ, NE, GE, or LE. Type attribute notation and Sub- 
string notation may also be used in character relations. The maximum 
size of the character expressions that can be compared is 255 characters. 
If the two character expressions are of unequal size, the smaller one will 
always compare less than the larger. 



1 -56 0S/VS1 Programmer's Reference Digest 



System Assembler Attributes 



Attribute 


Notation 


Can be used with: 


Can be used only if 
type attribute is: 


Can be used in: 


Type 


T' 


Ordinary Symbols de- 
fined in open code; 
symbolic parameters 
inside macro defini- 
tions; SET symbols, 
&SYSPARM, 
&SYSDATE, 
&SYSTlMh, inside 
or outside macro 
definitions; 
&SYSLIST (m), 
&SYSLIST(m,n), 
&SYSECT, 
&SYSNDX inside 
macro definitions 


(May always be used) 


1 . SETC operand 
fields 

2. Character 
relations 


Length 


L' 


Ordinary Symbols 
defined in open 
code; symbolic 
parameters inside 
macro definitions; 
&SYSLIST (m), and 
&SYSLIST(n,n) in- 
side macro definitions 


Any letter except 
M,N,0,TandU 


Arithmetic 
expressions 


Scaling 


S" 


Ordinary Symbols 
defined in open 
code; symbolic 
parameters inside 
macro definitions; 
&SYSLIST (m), and 
&SYSLIST(m,n) in- 
side macro definitions 


H,F,G,D,E,L,K,P, 
andZ 


Arithmetic 
expressions 


Integer 


1' 


Ordinary Symbols de- 
fined in open code; 
symbolic parameters 
inside macro defini- 
tions; &SYSLIST (m), 
and &SYSUST(m,n) 
inside macro de- 
finitions 


H,F,G,D,E,L,K,P, 
and Z 


Arithmetic 
expressions 


Count 


K' 


Symbolic parameters 
inside macro defini- 
tions; SET symbols; 
all system variable 
symbols 


Any letter 


Arithmetic 
expressions 


Number 


N' 


Symbolic parameters, 
&SYSLIST (m), and 
&SYSLIST (m,n) in- 
side macro definitions 


Any letter 


Arithmetic 
expressions 



Section 1: General Information 1-57 



System Assembler Variable Symbols 



Variable 


Declared by: 


Initialized, 


Value changed 


May be used in: 


Symbol 




or set to: 


by: 




Symbolic 


Prototype 


Corresponding 


(Constant 


• Arithmetic 


parameter 


statement 


macro instruc- 


throughout 


expressions 






tion operand 


definition) 


if operand 
is decimal 
self-defining 
term 

• Character 
expressions 


SETA 


LCLA or 





SETA 


• Arithmetic 




GBLA 




instruction 


expressions 




instruction 






• Character 
expressions 


SETB 


LCLB or 





SETB 


• Arithmetic 




GBLB 




instruction 


expressions 




instruction 






• Character 
expressions 

• Logical 
expressions 


SETC 


LCLC or 


String of 


SETC 


• Arithmetic 




GBLC 


length 


instruction 


expressions 




instruction 


(null) 




if value is 
decimal self- 
defining term 

• Character 
expressions 


&SYSNDX 1 


The assembler 


Macro 


(Constant 


• Arithmetic 






instruction 


throughout 


expressions 






index 


definition; 
unique for 
each macro 
instruction) 


• Character 
expressions 


&SYSECT 1 


The assembler 


Control 


(Constant 


• Character 






section in 


throughout 


expressions 






which macro 


definition; 








instruction 


set by CSECT, 








appears 


DSECT, START, 
and COM) 





1 -58 OS/VS 1 Programmer's Reference Digest 



System Assembler Variable Symbols (cont'd) 




Variable 
Symbol 


Declared by: 


Initialized, 
or set to: 


Value changed 
by: 


May be used in: 


&SYSLIST 1 


The assembler 


Not 
applicable 


Not 
applicable 


• N'&SYSLIST in 
arithmetic 
expressions 


&SYSUST 

(n) ! 

&SYSLIST 


The assembler 


Corresponding 
macro instruc- 
tion operand 


(Constant 
throughout 
definition) 


9 Arithmetic 
expressions 
if operand 
is decimal 
self-defining 
term 

« Character 
expressions 


&SYSPARM 


PARM field 


User defined 
or null 


Constant 

throughout 

assembly 


• Arithmetic 
expression 
if value is 
decimal self- 
defining term 

• Character 
expression 


&SYSTIME 


The assembler 


System time 


Constant 
throughout 
assembly 


o Character 
expression 


&SYSDATE 


The assembler 


System date 


Constant 

throughout 

assembly 


e Character 
expression 



Can be used only in macro definitions. 



Section 1: General Information 1-59 



Dynamic Address Translation - Hexadecimal and Decimal Conversion 

, DYNAMIC ADDRESS TRANSLATION 
VIRTUAL (LOGICAL) ADDRESS FORMAT 

Segment Index Page Index Byte Index 



Segment Size 


Page Size 


"Bits 


64K 


2K 


0-7 



16 -20 
12 -20 



21 - 31 
21 -31 



SEGMENT TABLE ENTRY 



|PT length | 



Page table addre 



34 



l^TTI 



*Normally zeros; ignored on s 
PAGE TABLE ENTRY (2K) 



28 29 
31 (I) Segment-invalid bit. 



13 (I) Page-invalid bit 



HEXADECIMAL AND DECIMAL CONVERSION 

From hex: locate each hex digit in its corresponding column position and note the decimal 
equivalents. Add these to obtain the decimal value. 

From decimal: (1 ) locate the largest decimal value in the table that will fit into the decimal 
number to be converted, and (2) note its hex equivalent and hex column position. (3) Find 
the decimal remainder. Repeat the process on this and subsequent remainders. 



HEXADECIMAL COLUMNS 


6 


5 


4 


3 


2 


1 


HEX = DEC 


HEX = DEC 


HEX = DEC 


HEX = DEC 


HEX = DEC 


HEX = DEC 




1 1,048,576 

2 2,097, 152 

3 3,145,728 

4 4,194,304 

5 5,242,880 

6 6,291,456 

7 7,340,032 

8 8,388,608 

9 9,437,184 
A 10,485,760 
B 11,534,336 
C 12,582,912 
D 13,631,488 
E 14,680,064 
F 15,728,640 




1 65,536 

2 131,072 

3 196,608 

4 262,144 

5 327,680 

6 393,216 

7 458,752 

8 524,288 

9 589,824 
A 655,360 
B 720,896 
C 786,432 
D 851,968 
E 917,504 
F 983,040 




1 4,096 

2 8,192 

3 12,288 

4 16,384 

5 20,480 

6 24,576 

7 28,672 

8 32, 768 

9 36,864 
A 40,960 
B 45,056 
C 49,152 
D 53,248 
E 57,344 
F 61,440 




1 256 

2 512 

3 768 

4 1,024 

5 1,280 

6 1,536 

7 1,792 

8 2,048 

9 2,304 
A 2, 560 
B 2,816 
C 3,072 
D 3,328 
E 3,584 
F 3,840 




1 16 . 

2 32 

3 48 

4 64 

5 80 

6 96 

7 112 

8 128 

9 144 
A 160 
B 176 
C 192 
D 208 
E 224 
F 240 




1 1 

2 2 

3 3 

4 4 

5 5 

6 6 

7 7 
•8 8 

9 9 
A 10 
B 11 
C 12 
D 13 
E 14 
F 15 


0123 


4567 


0123 


4567 


0123 


4567 


BYTE 


BYTE 


BYTE 



POWERS OF 2 


2 n 


n 


256 


8 


512 


9 


1 024 


10 


2 048 


11 


4 096 


12 


8 192 


13 


16 384 


14 


32 768 


15 


65 536 


16 


131 072 


17 


262 144 


18 


524 288 


19 


1 048 576 


20 


2 097 152 


21 


4 194 304 


22 


8 388 608 


23 


16 777216 


24 



POWERS OF 16 TABLE 



? = 


60 


2 4 = 


6l 


28 = 


62 


?12 = 


63 


2 16_ 


64 


? 20 = 


65 


2 M = 


66 


2 28 = 


67 


? 32 = 


6« 


236 = 


69 


240 = 


6l0 


244 = 


All 


248 = 


612 


252 = 


Al3 


256 = 


6'4 


260 = 


615 



16 n 


n 


1 





16 


1 


256 


2 


4 096 


3 


65 536 


4 


1 048 576 


5 


16 777 216 


6 


268 435 456 


7 


4 294 967 296 


8 


68 719 476 736 


9 


1 099 51 1 627 776 


10 


17 592 186 044 416 


11 


281 474 976 710 656 


12 


4 503 599 627 370 496 


13 


72 057 594 037 927 936 


14 


1 152 921 504 606 846 976 


15 



1-60 OS/VS1 Programmer's Reference Digest 



Hexadecimal Addition, Multiplication, Subtraction Tables 

Hexadecimal Addition and Subtraction Table 
Example: 6+2 = 8,8-2 = 6, and 8-6 = 2 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


1 


02 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


2 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


3 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


4 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


5 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


6 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


7 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


8 


09 


0A 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


9 


0A 


0B 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


A 


0B 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


B 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


C 


0D 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


D 


0E 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


E 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


ID 


F 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


ID 


IE 



Hexadecimal Multiplication Table 
Example: 2 x 4 = 08, F x 2 = IE 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


1 


01 


02 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


2 


02 


04 


06 


08 


OA 


OC 


OE 


10 


12 


14 


16 


18 


1A 


1C 


IE 


3 


03 


06 


09 


OC 


OF 


12 


15 


18 


IB 


IE 


21 


24 


27 


2A 


2D 


4 


04 


08 


OC 


10 


14 


18 


1C 


20 


24 


28 


2C 


30 


34 


38 


3C 


5 


05 


OA 


OF 


14 


19 


IE 


23 


28 


2D 


32 


37 


3C 


41 


46 


4B 


6 


06 


OC 


12 


18 


IE 


24 


2A 


30 


36 


3C 


42 


48 


4E 


54 


5A 


7 


07 


OE 


15 


1C 


23 


2A 


31 


38 


3F 


46 


4D 


54 


5B 


62 


69 


8 


08 


10 


18 


20 


28 


30 


38 


40 


48 


50 


58 


60 


68 


70 


78 


9 


09 


12 


IB 


24 


2D 


36 


3F 


48 


51 


5A 


63 


6C 


75 


7E 


87 


A 


OA 


14 


IE 


28 


32 


3C 


46 


50 


5A 


64 


6E 


78 


82 


8C 


96 


B 


OB 


16 


21 


2C 


37 


42 


4D 


58 


63 


6E 


79 


84 


8F 


9A 


A5 


C 


OC 


18 


24 


30 


3C 


48 


54 


60 


6C 


78 


84 


90 


9C 


A8 


B4 


D 


OD 


1A 


27 


34 


41 


4E 


5B 


68 


75 


82 


8F 


9C 


A9 


B6 


C3 


E 


OE 


1C 


2A 


38 


46 


54 


62 


70 


7E 


8C 


9A 


A8 


B6 


C4 


D2 


F 


OF 


IE 


2D 


3C 


4B 


5A 


69 


78 


87 


96 


A5 


B4 


C3 


D2 


El 



Section 1 : General Information 



Decimal to Hexadecimal Conversion Information 

Decimal to Hexadecimal Conversion : Locate the decimal fraction (.1973) in the table. If the exact 
figure is not shown, locate the next higher and lower fractions (.19726563, .19750977). The first 
digits of the hexadecimal fraction are at the top of the column C32). To locate the third digit, deter- 
mine by observation or subtraction the smaller difference between the known fraction and each of 
the found fractions. The smaller difference' identifies the correct line (.008). The hexadecimal equiva- 
lent is .328. 

If more places to the right of the decimal point are required in the hexadecimal fraction, multiply 
the decimal fraction by 16 and develop integers as successive terms of the hexadecimal fraction. 
Using the previous sample decimal fraction: 



Developed_ 
Integers "" 



3 


.1568 




16 


2 


.5088 



Hexadecimal to Decimal Conversion : Locate the first two digits (.1E) of the hexadecimal fraction 
(.1 E9) in the horizontal row of column headings. Locate the third digit (.009) in the left most 
column of the table. Follow the .009 line horizontally to the right to the .1E column. The decimal 
equivalent is .1 1938477. The decimal fractions in the table were carried to eight places and rounded. 
If 2 places are required, or if the hexadecimal fraction exceeds the capacity of the table, express the 
hexadecimal fraction as powers of 16 (expansion). For example: 



,1E94 16 = 1(16- 1 ) + 14(16- 2 ) + 9(16 3 ) +4(16- 4 ) 

= K.0625) + 14(.00390625) + 9(.000244440625) + 4(.00001 52587890625) 
= . 11 9445800781 2500, 



1-62 OS/VS1 Programmer's Reference Digest 



























Decimal to Hexadecimal Conversion Information (cont'd) 


.000 


.00 


.01 


.02 


.03 


.04 


.05 


.06 


.07 


.08 


.09 


• OA 


.OB 


.OC 


.OD 


.OE 


.OF 


.00000000 


.00390625 


.00781250 


.01171875 


.01562500 


.01953125 


.02343750 


.02734375 


.03125000 


.03515625 


.03906250 


.04296875 


.04687500 


.05078125 


.05468750 


.05859375 


.001 


.00024414 


.00415039 


.00805664 


.01196289 


.01586914 


.01977539 


.02368164 


.02758789 


.03149414 


.03540039 


.03930664 


.04321289 


.04711914 


.05102539 


.05493164 


.05883789 


.002 


.00048828 


.00439453 


.00830078 


.01220703 


.01611328 


.02001953 


.02392578 


.02783203 


.03173828 


.03564453 


.03955078 


.04345703 


.04736328 


.05126953 


.05517578 


.05908203 


.003 


.00073242 


.00463867 


.00854492 


.01245117 


.01635742 


.02026367 


.02416992 


.02807617 


.03198242 


.03588867 


.03979492 


.04370117 


.04760742 


.05151367 


.05541992 


.05932617 


.004 


.00097656 


.00488281 


.00878906 


.01269531 


.01660156 


.02050781 


.02441406 


.02832031 


.03222656 


.03613281 


.04003906 


.04394531 


.04785156 


.05175781 


.05566406 


.05957031 


.005 


.00122070 


.00512695 


.00903320 


.01293945 


.01684570 


.02075195 


.02465820 


.02856445 


.03247070 


.03637695 


.04028320 


.04418945 


.04809570 


.05200195 


.05590820 


.05981445 


.006 


.00146484 


.00537109 


.00927734 


.01318359 


.01708984 


.02099609 


.02490234 


.02880859 


.03271484 


.03662109 


.04052734 


.04443359 


.04833984 


.05224609 


.05615234 


.06005859 


.007 


.00170898 


.00561523 


.00952148 


.01342773 


.01733398 


.02124023 


.02514648 


.02905273 


.03295898 


.03686523 


.04077148 


.04467773 


.04858398 


.05249023 


.05639648 


.06030273 


.008 


.00195313 


.00585938 


.00976563 


.01367188 


.01757813 


.02148438 


.02539063 


.02929688 


.03320313 


.03710938 


.04101563 


.04492188 


.04882813 


.05273438 


.05664063 


.06054688 


.009 


.00219727 


.00610352 


.01000977 


.01391602 


.01782227 


.02172852 


.02563477 


.02954102 


.03344727 


.03735352 


.04125977 


.04516602 


.04907227 


.05297852 


.05688477 


.06079102 


.00 A 


.00244141 


.00634766 


.01025391 


.01416016 


.01806641 


.02197266 


.02587891 


.02978516 


.03369141 


.03759766 


.04150391 


.04541016 


.04931641 


.05322266 


.05712891 


.06103516 


.00B 


.00268555 


.00659180 


.01049805 


.01440430 


.01831055 


.02221680 


.02612305 


.03002930 


.03393555 


.03784180 


.04174805 


.04565430 


.04956055 


.05346680 


.05737305 


.06127930 


.OOC 


.00292969 


.00683594 


.01074219 


.01464844 


.01855469 


.02246094 


.02636719 


.03027344 


.03417969 


.03808594 


.04199219 


.04589844 


.04980469 


.05371094 


.05761719 


.06152344 


.OOD 


.00317383 


.00708008 


.01098633 


.01489258 


.01879883 


.02270508 


.02661133 


.03051758 


.03442383 


.03833008 


.04223633 


.04614258 


.05004883 


.05395508 


.05786133 


.06176758 


.OOE 


.00341797 


.00732422 


.01123047 


.01513672 


.01904297 


.02294922 


.02685547 


.03076172 


.03466797 


.03857422 


.04248047 


.04638672 


.05029297 


.05419922 


.05810547 


.06201172 


• OOF 


.00366211 


.00756836 


.01147461 


.01538086 


.01928711 


.02319336 


.02709961 


.03100586 


.03491211 


.03881836 


.04272461 


.04663086 


.05053711 


.05444336 


.05834961 


.06225586 


.000 


.16 


.11 


.12 


.13 


.14 


.15 


.16 


.17 


.18 


.19 


.1A 


.IB 


.1C 


.ID 


.IE 


.IF 


.06250000 


.06640625 


.07031250 


.07421875 


.07812500 


.08203125 


.08593750 


.08984375 


.09375000 


.09765625 


.10156250 


. 10546875 


. 10937500 


.11328125 


.11718750 


.12109375 


.001 


.06274414 


.06665039 


.07055664 


.07446289 


.07836914 


.08227539 


.08618164 


.09008789 


.09399414 


.09790039 


.10180664 


.10571289 


.10961914 


.11352539 


.11743164 


.12133789 


.002 


.06298828 


.06689453 


.07080078 


.07470703 


.07861328 


.08251953 


.08642578 


.09033203 


.09423828 


.09814453 


. 10205078 


. 10595703 


. 10986328 


.11376953 


.11767578 


.12158203 


.003 


.06323242 


.06713867 


.07104492 


.07495117 


.07885742 


.08276367 


.08666992 


.09057617 


.09448242 


.09838867 


. 10229492 


.10620117 


.11010742 


.11401367 


.11791992 


.12182617 


.004 


.06347656 


.06738281 


.07128906 


.07519531 


.07910156 


.08300781 


.08691406 


.09082031 


.09472656 


.09863281 


. 10253906 


.10644531 


.11035156 


.11425781 


.11816406 


.12207031 


.005 


.06372070 


.06762695 


.07153320 


.07543945 


.07934570 


.08325195 


.08715820 


.09106445 


.09497070 


.09887695 


. 10278320 


. 10668945 


. 1 1059570 


.11450195 


.11840820 


.12231445 


.006 


.06396484 


.06787109 


.07177734 


.07568359 


.07958984 


.08349609 


.08740234 


.09130859 


.09521484 


.09912109 


. 10302734 


. 10693359 


. 1 1083984 


.11474609 


.11865234 


.12255859 


.007 


.06420898 


.06811523 


.07202148 


.07592773 


.07983398 


.08374023 


.08764648 


.09155273 


.09545898 


.09936523 


.10327148 


.10717773 


. 1 1 108398 


.11499023 


.11889648 


.12280273 


.008 


.06445313 


.06835938 


.07226563 


.07617188 


.08007813 


.08398438 


.08789063 


.09179688 


.09570313 


.09960938 


.10351563 


.10742188 


.11132813 


.11523438 


.11914063 


.12304688 


.009 


.06469727 


.06860352 


.07250977 


.07641602 


.08032227 


.08422852 


.08813477 


.09204102 


.09594727 


.09985352 


.10375977 


. 10766602 


.11157227 


.11547852 


.11938477 


.12329102 


.00 A 


.06494141 


.06884766 


.07275391 


.07666016 


.08056641 


.08447266 


.08837891 


.09228516 


.09619141 


. 10009766 


. 10400391 


.10791016 


.11181641 


.11572266 


.11962891 


.12353516 


• OOB 


.06518555 


.06909180 


.07299805 


.07690430 


.08081055 


.08471680 


.08862305 


.09252930 


.09643555 


. 10034180 


. 10424805 


.10815430 


.11206055 


.11596680 


. 1 1987305 


.12377930 , 


.OOC 


.06542969 


.06933594 


.07324219 


.07714844 


.08105469 


.08496094 


.08886719 


.09277344 


.09667969 


. 10058594 


.10449219 


. 10839844 


.11230469 


.11621094 


.12011719 


.12402344 


.OOD 


.06567383 


.06958008 


.07348633 


.07739258 


.08129883 


.08520508 


.08911133 


.09301758 


.09692383 


. 10083008 


. 10473633 


. 10864258 


.11254883 


.11645508 


.12036133 


.12426758 i 


:00E 


.06591797 


.06982422 


.07373047 


.07763672 


.08154297 


.08544922 


.08935547 


.09326172 


.09716797 


.10107422 


. 10498047 


. 10888672 


.11279297 


. 1 1669922 


.12060547 


.12451172 


.OOF 


.06616211 


.07006836 


.07397461 


.07788086 


.08178711 


.08569336 


.08959961 


.09350586 


.09741211 


.10131836 


.10522461 


.10913086 


.11303711 


. 1 1694336 


.12084961 


.12475586 


.000 


.20 


.21 


.22 


.23 


.24 


.25 


.26 


.27 


.28 


.29 


.2A 


.2B 


.2C 


.2D 


.2E 


.2F 


.12500000 


.12890625 


.13281250 


.13671875 


.14062500 


.14453125 


.14843750 


.15234375 


.15625000 


.16015625 


. 16406250 


. 16796875 


.17187500 


.17578125 


.17968750 


.18359375 1 


.001 


.12524414 


.12915039 


.13305664 


. 13696289 


.14086914 


.14477539 


.14868164 


.15258789 


.15649414 


. 16040039 


.16430664 


.16821289 


.17211914 


.17602539 


.17993164 


.18383789 


.002 


.12548828 


.12939453 


.13330078 


.13720703 


.14111328 


.14501953 


.14892578 


.15283203 


.15673828 


. 16064453 


. 16455078 


. 16845703 


.17236328 


.17626953 


.18017578 


.18408203 


.003 


.12573242 


.12963867 


.13354492 


.13745117 


.14135742 


. 14526367 


.14916992 


.15307617 


.15698242 


. 16088867 


. 16479492 


.16870117 


.17260742 


.17651367 


.18041992 


.18432617 


.004 


.12597656 


.12988281 


.13378906 


.13769531 


.14160156 


.14550781 


.14941406 


.15332031 


.15722656 


.16113281 


. 16503906 


.16894531 


.17285156 


.17675781 


.18066406 


.18457031 


.005 


.12622070 


.13012695 


.13403320 


.13793945 


.14184570 


.14575195 


.14965820 


.15356445 


.15747070 


.16137695 


.16528320 


.16918945 


.17309570 


.17700195 


.18090820 


.18481445 


.006 


.12646484 


.13037109 


.13427734 


.13818359 


.14208984 


. 14599609 


.14990234 


.15380859 


.15771484 


.16162109 


. 16552734 


. 16943359 


.17333984 


.17724609 


.18115234 


.18505859 


.007 


.12670898 


.13061523 


.13452148 


.13842773 


.14233398 


. 14624023 


.15014648 


.15405273 


.15795898 


.16186523 


.16577148 


. 16967773 


.17358398 


.17749023 


.18139648 


.18530273 


.008 


.12695313 


.13085938 


.13476563 


.13867188 


.14257813 


.14648438 


.15039063 


.15429688 


.15820313 


. 16210938 


.16601563 


.16992188 


.17382813 


.17773438 


.18164063 


.18554688 


.009 


.12719727 


.13110352 


.13500977 


.13891602 


.14282227 


. 14672852 


.15063477 


.15454102 


.15844727 


. 16236352 


.16625977 


.17016602 


.17407227 


.17797852 


.18188477 


.18579102 


.00 A 


.12744141 


.13134766 


.13525391 


.13916016 


.14306641 


. 14697266 


.15087891 


.15478516 


.15869141 


. 16259766 


.16650391 


.17041016 


.17431641 


.17822266 


.18212891 


.18603516 


.OOB 


.12768555 


.13159180 


.13549805' 


.13940430 


.14331055 


.14721680 


.15112305 


.15502930 


.15893555 


.16284180 


. 16674805 


.17065430 


.17456055 


.17846680 


.18237305 


.18627930 


.OOC 


.12792969 


.13183594 


.13574219 


.13964844 


.14355469 


.14746094 


.15136719 


.15527344 


.15917969 


. 16308594 


.16699219 


.17089844 


.17480469 


.17871094 


.18261719 


.18652344 


.OOD 


.12817383 


.13208008 


.13598633 


.13989258 


.14379883 


.14770508 


.15161133 


.15551758 


.15942383 


. 16333008 


.16723633 


.17114258 


.17504883 


.17895508 


.18286133 


.18676758 i 


.OOE 


.12841797 


.13232422 


.13623047 


.14013672 


.14404297 


.14794922 


.15185547 


.15576172 


.15966797 


. 16357422 


.16748047 


.17138672 


.17529297 


.17919922 


.18310547 


.18701172 


.OOF 


.12866211 


.13256836 


.13647461 


.14038086 


.14428711 


.14819336 


.15209961 


.15600586 


.15991211 


.16381836 


.16772461 


.17163086 


.17553711 


.17944336 


.18334961 


.18725586 ! 


.000 


.30 


.31 


.32 


.33 


.34 


.35 


.36 


.37 


.38 


.39 


.3A 


.3B 


.3C 


.3D 


.3E 


.3F 


.18750000 


.19140625 


.19531250 


.19921875 


.20312500 


.20703125 


.21093750 


.21484375 


.21875000 


.22265625 


.22656250 


. 23046875 


.23437500 


.23828125 


.24218750 


. 24609375 


.001 


.18774414 


.19165039 


.19555664 


.19946289 


.20336914 


.20727539 


.21118164 


.21508789 


.21899414 


.22290039 


.22680664 


.23071289 


.23461914 


.23852539 


.24243164 


.24633789 


.002 


. 18798828 


.19189453 


.19580078 


. 19970703 


.20361328 


.20751953 


.21142578 


.21533203 


.21923828 


.22314453 


.22705078 


23095703 


.23486328 


.23876953 


.24267578 


.24658203 


.003 


. 18823242 


.19213867 


.19604492 


.19995117 


.20385742 


.20776367 


.21166992 


.21557617 


.21948242 


.22338867 


.22729492 


.23120117 


.23510742 


.23901367 


.24291992 


.24682617 


.004 


. 18847656 


.19238281 


.19628906 


.20019531 


.20410156 


.20800781 


.21191406 


.21582031 


.21972656 


.22363281 


.22753906 


.23144531 


.23535156 


.23925781 


.24316406 


.24707031 


.005 


. 18872070 


.19262695 


.19653320 


.20043945 


.20434570 


.20825195 


.21215820 


.21606445 


.21997070 


.22387695 


.22778320 


.23168945 


.23559570 


.23950195 


.24340820 


.24731445 


.006 


. 18896484 


.19287109 


.19677734 


.20068359 


.20458984 


. 20849609 


.21240234 


.21630859 


.22021484 


.22412109 


.22802734 


.23193359 


.23583984 


.23974609 


.24365234 


.24755859 


.007 


. 18920898 


.19311523 


.19702148 


.20092773 


.20483398 


.20874023 


.21264648 


.21655273 


.22045898 


.22436523 


.22827148 


.23217773 


.23608398 


.23999023 


.24389648 


.24780273 


.008 


.18945313 


.19335938 


.19726563 


.20117188 


.20507813 


. 20898438 


.21289063 


.21679688 


.22070313 


.22460938 


.22851563 


.23242188 


.23632813 


.24023438 


.24414063 


.24804688 


.009 


.18969727 


. 19360352 


.19750971 


.20141602 


.20532227 


.20922852 


.21313477 


.21704102 


.22094727 


.22485352 


.22875977 


.23266602 


.23657227 


.24047852 


.24438477 


.24829102 


.00 A 


.18994141 


.19384766 


.19775391 


.20166016 


. .20556641 


. 20947266 


.21337891 


.21728516 


.22119141 


.22509766 


.22900391 


.23291016 


.23681641 


.24072266 


.24462891 


.24853516 


.OOB 


.19018555 


.19409180 


.19799805 


.20190430 


.20581055 


.20971680 


.21362305 


.21752930 


.22143555 


.22534180 


.22924805 


.23315430 


.23706055 


.24096680 


.24487305 


.24877930 


.OOC 


.19042969 


.19433594 


.19824219 


.20214844 


.20605469 


.20996094 


.21386719 


.21777344 


.22167969 


.22558594 


.22949219 


.23339844 


.23730469 


.24121094 


.24511719 


.24902344 


.OOD 


.19067383 


.19458008 


.•19848633 


.20239258 


.20629883 


.21020508 


.21411133 


.21801758 


.22192383 


.22583008 


.22973633 


.23364258 


.23754883 


.24145508 


.24536133 


.24926758 


.OOE 


.19091797 


.19482422 


.19873047 


.20263672 


.20654297 


.21044922 


.21435547 


.21826172 


.22216797 


.22607422 


.22998047 


.23388672 


.23779297 


.24169922 


.24560547 


.24951172 


.OOF 


.19116211 


.19506836 


.19897461 


.20288086 


.20678711 


.21069336 


.21459961 


.21850586 


.22241211 


.22631836 


.23022461 


.23413086 


.23803711 


.24194336 


.24584961 


.24975586 



Section 1 : General Information 1 -63 



Decimal to Hexadecimal Conversion Information (cont'd) 



.000 


.40 


.41 


.42 


.43 


.44 


.45 


.46 


.47 


.48 


.49 


.4A 


.4B 


.4C 


.4D 


• 4E 


4F 


.25000000 


.25390625 


.25781250 


.26171875 


.26562500 


.26953125 


. 27343750 


.27734375 


.28125000 


.28515625 


. 28906250 


. 29296875 


.29687500 


.30078125 


.30468750 


.30859375 


.001 


.25024414 


.25415039 


.25805664 


.26196289 


.26586914 


.26977539 


.27368164 


.27758789 


.28149414 


. 28540039 


. 28930664 


.29321289 


.29711914 


.30102529 


.30493164 


.30883789 


.002 


.25048828 


.25439453 


.25830078 


.26220703 


.26611328 


.27001953 


. 27392578 


.27783203 


.28173828 


. 28564453 


. 28955078 


.29345703 


.29736328 


.30126953 


.30517578 


.30908203 


.003 


.25073242 


.25463867 


.25854492 


.26245117 


.26635742 , 


. 27026367 


.27416992 


.27807617 


.28198242 


. 28588867 


. 28979492 


.29370117 


.29760742 . 


.30151367 


.30541992 


.30932617 


.004 


.25097656 


.25488281 


.25878906 


.26269531 


.26660156 


.27050781 


.27441406 


.27832031 


. 28222656 


.28613281 


. 29003906 


.29394531 


.29785156 


.30175781 


.30566406 


.30957031 


.005 


.25122070 


.25512695 


.25903320 


.26293945 


.26684570 


.27075195 


.27465820 


. 27856445 


.28247070 


.28637695 


.29028320 


.29418945 


.29809570 


.30200195 


.30590820 


.30981445 


.006 


.25146484 


.25537109 


.25927734 


.26318359 


.26708984 


.27099609 


. 27490234 


.27880859 


.28271484 


.28662109 


. 29052734 


.29443359 


.29833984 


.30224609 


.30615234 


.31005859 


.007 


.25170898 


.25561523 


.25952148 


.26342773 


.26733398 


.27124023 


.27514648 


.27905273 


.28295898 


. 28686523 


.29077148 


.29467773 


.29858398 


.30249023 


.30639648 


.31030273 


.008 


.25195313 


.25585938 


.25976563 


.26367188 


.26757813 


.27148438 


.27539063 


.27929688 


.28320313 


.28710938 


.29101563 


.29492188 


.29882813 


.30273438 


.30664063 


.31054688 


.009 


.25219727 


.25610352 


.26000977 


.26391602 


.26782227 


.27172852 


.27563477 


.27954102 


.28344727 


. 28735352 


.29125977 


.29516602 


.29907227 


.30297852 


.30688477 


.31079102 


.00A 


.25244141 


.25634766 


.26025391 


.26416016 


.26806641 


.27197266 


.27587891 


.27978516 


.28369141 


. 28759766 


.29150390 


.29541016 


.29931641 


.30322266 


.30712891 


.31103516 


.00B 


.25268555 


.25659180 


.26049805 


.26440430 


.26831055 


.27221680 


.27612305 


.28002930 


.28393555 


.28784180 


.29174805 


.29565430 


.29956055 


.30346680 


.30737305 


.31127930 


.OOC 


.25292969 


.25683594 


.26074219 


.26464844 


.26855469 


.27246094 


.27636719 


.28027344 


.28417969 


.28808594 


.29199219 


. 29589844 


.29980469 


.30371094 


.30761719 


.31152344 


.00D 


.25317383 


.25708008 


.26098633 


.26489258 


.26879883 


. 27270508 


.27661133 


.28051758 


.28442383 


.28833008 


. 29223633 


.29614258 


.30004883 


.30395508 


.30786133 


.31176758 


.00E 


.25341797 . 


.25732422 


.26123047 


.26513672 


.26904297 


.27294922 


. 27685547 


.28076172 


.28466797 


.28857422 


. 29248047 


.29638672 


.30029297 


.30419922 


.30810547 


.31201172 


.OOF 


.25366211 


.25756836 


.26147461 


.26538086 


.26928711 


.27319336 


.27709961 


: 28 100586 


.28491211 


.28881836 


.29272461 


.29663086 


.30053711 


.30444336 


.30834961 


.31225586 


.000 


.56 


.51 


.52 


.53 


.54 


.55 


.56 


.57 


.58 


.59 


.5A 


.5B 


.5C 


.5D 


.5E 


.5F 


.31250000 


.31640625 


.32031250 


.32421875 


.32812500 


.33203125 


.33593750 


.33984375 


.34375000 


.34765625 


.35156250 


.35546875 


.35937500 


.36328125 


.36718750 


.37109375 


.001 


.31274414 


.31665039 


.32055664 


.32446289 


.32836914 


.33227539 


.33618164 


.34008789 


.34399414 


.34790039 


.35180664 


.35571289 


.35961914 


.36352539 


.36743164 


.37133789 


.002 


.31298828 


.31689453 


.32080078 


.32470703 


.32861328 


.33251953 


.33642578 


.34033203 


.34423828 


.34814453 


.35205078 


.35595703 


.35986328 


.36376953 


.36767578 


.37158203 


.003 


.31323242 


.31713867 


.32104492 


.32495117 


.32885742 


.33276367 


.33666992 


.34057617 


.34448242 


.34838867 


.35229492 


.35620117 


.36010742 


.36401367 


.36791992 


.37182617 


.004 


.31347656 


.31738281 


.32128906 


.32519531 


.32910156 


.33300781 


.33691406 


.34082031 


.34472656 


.34863281 


.35253906 


.35644531 


.36035156 


.36425781 


.36816406 


.37207031 


.005 


.31372070 


.31762695 


.32153320 


.32543945 


.32934570 


.33325195 


.33715820 


.34106445 


.34497070 


.34887695 


.35278320 


.35668945 


.36059570 


.36450195 


.36840820 


.37231445 


.006 


.31396484 


.31787109 


.32177734 


.32568359 


.32958984 


.33349609 


.33740234 


.34130859 


.34521484 


.34912109 


.35302734 


.35693359 


.36083984 


.36474609 


.36865234 


.37255859 


.007 


.31420898 


.31811523 


.32202148 


.32592773 


.32983398 


.33374023 


.33764648 


.34155273 


.34545898 


.34936523 


.35327148 


.35717773 


.36108398 


.36499023 


.36889648 


.37280273 


.008 


.31445313 


.31835938 


.32226563 


.32617188 


.33007813 


.33398438 


.33789063 


.34179688 


.34570313 


.34960938 


.35351563 


.35742188 


.36132813 


.36523438 


.36914063 


.37304688 


.009 


.31469727 


.31860352 


.32250977 


.32641602 


'33032227 


.33422852 


.33813477 


.34204102 


.34594727 


.34985352 


.35375977 


.35766602 


.36157227 


.36547852 


.36938477 


.-37329102 


.00A 


.31494141 


.31884766 


.32275391 


.32666016 


.33056641 


.33447266 


.33837891 


.34228516 


.34619141 


.35009766 


.35400391 


.35791016 


.36181641 


.36572266 


.36962891 


.37353516 


.00B 


.31518555 


.31909180 


.32299805 


.32690430 


.33081055 


.33471680 


.33862305 


.34252930 


.34643555 


.35034180 


.35424805 


.35815430 


.36206055 


.36596680 


.36987305 


.37377930 


.OOC 


.31542969 


.31933594 


.32324219 


.32714844 


.33105469 


.33496094 


.33886719 


.34277344 


.34667969 


.35058594 


.35449219 


.35839844 


.36230469 


.36621094 


.37011719 


.37402344 


.00D 


.31567383 


.31958008 


.32348633 


.32739258 


.33129883 


.33520508 


.33911133 


.34301758 


.34692383 


.35083008 


.35473633 


.35864258 


.36254883 


.36645508 


.37036133 


.37426758 


.00E 


.31591797 


.31982422 


.32373047 


.32763672 


.33154297 


.33544922 


.33935547 


.34326172 


.34716797 


.35107422 


.35498047 


.35888672 


.36279297 


.36669922 


.37060547 


.37451172 


.OOF 


.31616211 


.32006836 


.32397461 


.32788086 


.33178711 


.33569336 


.33959961 


.34350586 


.34741211 


.35131836 


.35522461 


.35913086 


.36303711 


.36694336 


.37084961 


.37475586 


.000 


.60 


.61 


.62 


.63 


.64 


.65 


.66 


.67 


.68 


.69 


.6A 


.6B 


.6C 


.6D 


.6E 


.6F 


.37500000 


.37890625 


.38281250 


.38671875 


.39062500 


.39453125 


.39843750 


.40234375 


.40625000 


.41015625 


.41406250 


.41796875 


.42187500 


.42578125 


.42968750 


.43359375 


.001 


.37524414 


.37915039 


.38305664 


.38696289 


.39086914 


.39477539 


.39868164 


.40258789 


.40649414 


.41040039 


.41430664 


.41821289 


.42211914 


.42602539 


.42993164 


.43383789 


.002 


.37548828 


.37939453 


.38330078 


.38720703 


.39111328 


.39501953 


.39892578 


.40283203 


.40673828 


.41064453 


.41455078 


.41845703 


.42236328 


.42626953 


.43017578 


.43408203 


.003 


.37573242 


.37963867 


.38354492 


.38745117 


.39135742 


.39526367 


.39916992 


.40307617 


.40698242 


.41088867 


.41479492 


.41870117 


.42260742 


.42651367 


.43041992 


.43432617 


.004 


.37597656 


.37988281 


.38378906 


.38769531 


.39160156 


.39550781 


.39941406 


.40332031 


.40722656 


.41113281 


.41503906 


.41894531 


.42285156 


.42675781 


.43066406 


.43457031 


.005 


.37622070 


.38012695 


.38403320 


.38793945 


.39184570 


.39575195 


.39965820 


.40356445 


.40747070 


.41137695 


.41528320 


.41918945 


.42309570 


.42700195 


.43090820 


.43481445 


.006 


.37646484 


.38037109 


.38427734 


.38818359 


.39208984 


.39599609 


.39990234 


.40380859 


.40771484 


.41162109 


.41552734 


.41943359 


.42333984 


.42724609 


.43115234 


.43505859 


.007 


.37670898 


.38061523 


.38452148 


.38842773 


.39233398 


.39624023 


.40014648 


.40405273 


.40795898 


.41186523 


.41577148 


.41967773 


.42358398 


.42749023 


.43139648 


.43530273 


.008 


.37695313 


.38085938 


.38476563 


.38867188 


.39257813 


.39648438 


.40039063 


.40429688 


.40820313 


.41210938 


.41601563 


.41992188 


.42382813 


.42773438 


.43164063 


.42554688 


.009 


.37719727 


.38110352 


.38500977 


.38891602 


.39282227 


.39672852 


.40063477 


.40454102 


.40844727 


.41235352 


.41625977 


.42016602 


.42407227 


.42797852 


.43188477 


.43579102 


.00 A 


.37744141 


.38134766 


.38525391 


.38916016 


.39306641 


.39697266 


.40087891 


.40478516 


.40869141 


.41259766 


.41650391 


.42041016 


.42431641 


.42822266 


.43212891 


.43603516 


.00B 


.37768555 


.38159180 


.38549805 


.38940430 


.39331055 


.39721680 


.40112305 


.40502930 


.40893555 


.41284180 


.41674805 


.42065430 


.42456055 


.42846680 


.43237305 


.43627930 


.OOC 


.37792969 


.38183594 


.38574219 


.38964844 


.39355469 


.39746094 


.40136719 


.40527344 


.40917969 


.41308594 


.41699219 


.42089844 


.42480469 


.42871094 


.'43261719 


.43652344 


.00D 


.37817383 


.38208008 


.38598633 


.38989258 


.39379883 


.39770508 


.40161133 


.40551758 


.40942383 


.41333008 


.41723633 


.42114258 


.42504883 


.42895508 


.43286133 


.43676758 


.OOE 


.37841797 


.38232422 


.38623047 


.39013672 


.39404297 


.39794922 


.40185547 


.40576172 


.40966797 


.41357422 


.41748047 


.42138672 


.42529297 


.42919922 


.43310547 


.43701172 


.OOF 


.37866211 


.38256836 


.38647461 


.39038086 


.39428711 


.39819336 


.40209961 


.40600586 


.40991211 


.41381836 


.41772461 


.42163086 


.42553711 


.42944336 


.43334961 


.43725586 


.000 


.70 


.71 


.72 


.73 


.74 


.75 


.76 


.77 


.78 


.79 


.7 k 


• 7B 


.7C 


.70 


.7E 


.7F 


.43750000 


.44140625 


.44531250 


.44921875 


.45312500 


.45703125 


.46093750 


.46484375 


.46875000 


.47265625 


.47656250 


.48046575 


.48437500 


.48828125 


.49218750 


.49609375 


.001 


.43774414 


.44165039 


.44555664 


.44946289 


.45336914 


.45727539 


.46118164 


.46508789 


.46899414 


.47290039 


.47680664 


.48071289 


.48461914 


.48852539 


.49243164 


.49633789 


.002 


.43798828 


.44189453 


.44580078 


.44970703 


.45361328 


.45751953 


.46142578 


.46533203 


.46923828 


.47314453 


.47705078 


.48095703 


.48486328 


.48876953 


.49267578 


.49658203 


.003 


.43823242 


.44213867 


.44604492 


.44995117 


.45385742 


.45776367 


.46166992 


.46557617 


.46948242 


.47338867 


.47729492 


.48120117 


.48510742 


.48901367 


.49291992 


.49682617 


.004 


.43847656 


.44238281 


.44628906 


.45019531 


.45410156 


.45800781 


.46191406 


.46582031 


.46972656 


.47363281 


.47753906 


.48144531 


.48535156 


.48925781 


.49316406 


.49707031 


.005 


.43872070 


.44262695 


.44653320 


.45043945 


.45434570 


.45825195 


.46215820 


.46606445 


.46997070 


.47387695 


.47778320 


.48168945 


.48559570 


.48950195 


.49340820 


.49731445 


.006 


.43896484 


.44287109 


.44677734 


.45068359 


.45458984 


.45849609 


.46240234 


.46630859 


.47021484 


.47412109 


.47802734 


.48193359 


.48583984 


.48974609 


.49365234 


.49755859 


.007 


.43920898 


.44311523 


.44702148 


.45092773 


.45483398 


.45874023 


.46264648 


.46655273 


.47045898 


.47436523 


.47827148 


.48217775 


.48608398 


.48999023 


.49389648 


.49780273 


.008 


.43945313 


.44335938 


.44726563 


.45117188 


.45507813 


.45898433 


.46289063 


.46679688 


.47070313 


.47460938 


.47851563 


.48242188 


.48632813 


.49023438 


.49414063 


.49804688 


.009 


.43969727 


.44360352 


.44750977 


.45141602 


.45532227 


.45922852 


.46313477 


.46704102 


.47094727 


.47485352 


.47875977 


.48266602 


.48657227 


.49047852 


.49438477 


.49829102 


.00 A 


.43994141 


.44384766 


.44775391 


.45166016 


.45556641 


.45947266 


.46337891 


.46728516 


.47119141 


.47509766 


.47900391 


.48291016 


.48681641 


.49072266 


.49462891 


,49853516 


.OOB 


.44018555 


.44409180 


.44799805 


.45190430 


.45581055 


.45971680 


.46362305 


.46752930 


.47143555 


.47534180 


.47924805 


.48315430 


.48706055 


.49096680 


.49487305 


.49877930 


.OOC 


.44042969 


.4-1433594 


.44824219 


.45214844 


.45605469 


.45996094 


.46386719 


.46777344 


.47167969 


.47558594 


.47949219 


.48339844 


.48730469 


.49121094 


.49511719 


.49902344 


.OOD 


.44067383 


.44458008 


.44848633 


.45239258 


.45629883 


.46020508 


.46411133 


.46801758 


.47192383 


.47583008 


.47973633 


.48364258 


.48754883 


.49145508 


.49536133 


.49926758 


.OOE 


.44091797 


.44482422 


.44873047 


.45263672 


.45654297 


.46044922 


.46435547 


.46826172 


.47216797 


.47607422 


.47998047 


.48388672 


.48779297 


.49169922 


.49560547 


.49951172 


.OOF 


.44116211 


.44506836 


.44897461 


.45288086 


.45678711 


.46069336 


.46459961 


.46850586 


.47241211 


.47631836 


.48022461 


.48413086 


.48803711 


.49194336 


.49584961 


.49975586 


1-64 


0S/VS1 Programmer's Reference Digest 





























Decimal to Hexadecimal Conversion Information (cont'd) 



.000 


.80 


.81 


.82 


.83 


.84 


, .85 


.86 


.87 


.88 


.89 


.8A 


, .8B 


.8C 


.8D 


.8E 


.8F 


.50000000 


.50390625 


.50781250 


.51171875 


.51562500 


.51953125 


.52343750 


.52734375 


.53125000 


.53515625 


.53906250 


.54296875 


.54687500 


.55078125 


.55468750 


.55859375 


.001 


.50024414 


.50415039 


.50805664 


.51196289 


.51586914 


.51977539 


.52368164 


.52758789 


.53149414 


.53540039 


.53930664 


.54321289 


.54711914 


.55102539 


.55493164 


.55883789 


.002 


.50048828 


.50439453 


.50830078 


.51220703 


.51611328 


.52001953 


.52392578 


.52783203 


.53173828 


.53564453 


.53955078 


.54345703 


.54736328 


.55126953 


.55517578 


.55908203 


.003 


.50073242 


.50463867 


.50854492 


.51245117 


.51635742 


.52026367 


.52416992 


.52807617 


.53198242 


.53588867 


.53979492 


.54370117 


.54760742 


.55151367 


.55541992 


.55932617 


.004 


.50097656 


.50488281 


.50878906 


.51269531 


.51660156 


.52050781 


.52441406 


.52832031 


.53222656 


.53613281 


.54003906 


.54394531 


.54785156 


.55175781 


.55566406 


.55957031 


.005 


.50122070 


.50512695 


.50903320 


.51293945 


.51684570 


.52075195 


.52465820 


.52856445 


.53247070 


.53637695 


.54028320 


.54418945 


.54809570 


.55200195 


.55590820 


.55981445 


.006 


.50146484 


.50537109 


.50927734 


.51318359 


.51708984 


.52099609 


.52490234 


.52880859 


.53271484 


.53662109 


.54052734 


.54443359 


.54833984 


.55224609 


.55615234 


.56005859 


.007 


.50170898 


.50561523 


.50952148 


.51342773 


.51733398 


.52124023 


.52514648 


.52905273 


.53295898 


.53686523 


.54077148 


.54467773 


..54858398 


.55249023 


.55639648 


.56030273 


.008 


.50195313 


.50585938 


.50976563 


.51367188 


.51757813 


.52148438 


.52539063 


.52929688 


.53320313 


.53710938 


.54101563 


.54492188 


.54882813 


.55273438 


.55664063 


.56054688 


.009 


.50219727 


.50610352 


.51000977 


.51391602 


.51782227 


.52172852 


.52563477 


.52954102 


.53344727 


.53735352 


.54125977 


.54516602 


.54907227 


.55297852 


.55688477 


.56079102 


.00A 


.50244141 


.50634766 


.51025391 


.51416016 


.51806641 


.52197266 


.52587891 


.52978516 


.53369141 


.53759766 


.54150391 


.54541016 


.54931641 


.55322266 


.55712891 


.56103516 


.O0B 


.50268555 


.50659180 


.51049805 


.51440430 


.51831055 


.52221680 


.52612305 


.53002930 


.53393555 


.53784180 


.54174805 


.54565430 


.54956055 


.55346680 


.55737305 


.56127930 


.00C 


.50292969 


.50683594 


.51074219 


.51464844 


.51855469 


.52246094 


.52636719 


.53027344 


.53417969 


.53808594 


.54199219 


.54589844 


.54980469 


.55371094 


.55761719 


.56152344 


.00D 


.50317383 


.50708008 


.51098633 


.51489258 


.51879883 


.52270508 


.52661133 


.53051758 


.53442383 


.53833008 


.54223633 


.54614258 


.55004883 


.55395508 


.55786133 


.56176758 


.00E 


.50341797 


.50732422 


.51123047 


.51513672 


.51904297 


.52294922 


.52685547 


.53076172 


.53466797 


.53857422 


.54248047 


.54638672 


.55029297 


.55419922 


.55810547 


.56201172 


.OOF 


.50366211 


.50756836 


.51147461 


.51538086 


.51928711 


.52319336 


.52709961 


.53100586 


.53491211 


.53881836 


.54272461 


.54663086 


.55053711 


.55444336 


.55834961 


.56225586 


.000 


.90 


.91 


.92 


.93 


.94 


.95 


.96 


.97 


.98 


.99 


.9A 


.96 


.9C 


.9D 


.9E 


.9F 


.56250000 


.56640625 


.57031250 


.57421875 


.57812500 


.58203125 


.5859375a 


.58984375 


.59375000 


.59765625 


.60156250 


.60546875 


.60937500 


.61328125 


.61718750 


.62109375 


.001 


.56274414 


.56665039 


.57055664 


.57446289 


.57836914 


.58227539 


.58618164 


.59008789 


.59399414 


.59790039 


.60180664 


.60571289 


.60961914 


.61352539 


.61743164 


.62133789 


.002 


.56298828 


.56689453 


.57080078 


.57470703 


.57861328 


.58251953 


.58642578 


.59033203 


.59423828 


.59814453 


.60205078 


.60595703 


.60986328 


.61376953 


.61767578 


.62158203 


.003 


.56323242 


.56713867 


.57104492 


.57495117 


.57885742 


.58276367 


.58666992 


.59057617 


.59448242 


.59838867 


.60229492 


.60620117 


.61010742 


.61401367 


.61791992 


.62182617 


.004 


.56347656 


.56738281 


.57128906 


.57519531 


.57910156 


.58300781 


.58691406 


.59082031 


.59472656 


.59863281 


.60253906 


.60644531 


.61035156 


.61425781 


.61816406 


.62207031 


.005 


.56372070 


.56762695 


.57153320 


.57543945 


.57934570 


.58325195 


.58715820 


.59106445 


.59497070 


.59887695 


.60278320 


.60668945 


.61059570 


.61450195 


.61840820 


.62231445 


.006 


.56396484 


.56787109 


.57177734 


.57568359 


.57958984 


.58349609 


.58740234 


.59130859 


.59521484 


.59912109 


.60302734 


.60693359 


.61083984 


.61474609 


.61865234 


.62255859 


.007 


.56420898 


.56811523 


.57202148 


.57592773 


.57983398 


.58374023 


.58764648 


.59155273 


.59545898 


.59936523 


.60327148 


.60717773 


.61108398 


.61499023 


.61889648 


.62280273 


.008 


.56445313 


.56835938 


.57226563 


.57617188 


.58007813 


.58398438 


.58789063 


.59179688 


.59570313 


.59960938 


.60351563 


.60742188 


.61132813 


.61523438 


.61914063 


.62304688 


.009 


.56469727 


.56860352 


.57250977 


.57641602 


.58032227 


.58422852 


.58813477 


.59204102 


.59594727 


.59985352 


.60375977 


.60766602 


.61157227 


.61547852 


,61938477 


.62329102 


.OOA 


.56494141 


.56884766 


.57275391 


.57666016 


.58056641 


.58447266 


.58837891 


.59228516 


.59619141 


.60009766 


.60400391 


.60791016 


.61181641 


.61572266 


.61962891 


.62343516 


.00B 


.56518555 


.56909180 


.57299805 


.57690430 


.58081055 


.58471680 


.58862305 


.59252930 


.59643555 


.60034180 


.60424805 


.60815430 


.61206055 


.61596680 


.61987305 


.62377930 


.OOC 


.56542969 


.56933594 


.57324219 


.57714844 


.58105469 


.58496094 


.58886719 


.59277344 


.59667969 


.60058594 


.60449219 


.60839844 


.61230469 


.61621094 


.62011719 


.62402344 


.OOD 


.56567383 


.56958008 


.57348633 


.57739258 


.58129883 


.58520508 


.58911133 


.59301758 


.59692383 


.60083008 


.60473633 


.60864258 


.61254883 


.61645508 


.62036133 


.62426758 


.OOE 


.56591797 


.56982422 


.57373047 


.57763672 


.58154297 


.58544922 


.58935547 


.59326172 


.59716797 


.60107422 


.60498047 


.60888672 


.61279297 


.61669922 


.62060547 


.62451172 


•OOF 


.56616211 


.57006836 


.57397461 


.57788086 


.58178711 


.58569336 


.58959961 


.59350586 


.59741211 


.60131836 


.60522461 


.60913086 


.61303711 


.61694336 


.62084961 


.62475586 


.000 


•AO - 


.Al 


.A2 


.A3 


.A4 


.A5 


.A6 


.A7 


.A8 


.A9 


.AA 


.AB 


.AC 


.AD 


.AE 


.AF 


.62500000 


.62890625 


.63281250 


.63671875 


.64062500 


.64453125 


.64843750 


.65234375 


.65625000 


.66015625 


.66406250 


.66796875 


.67187500 


.67578125 


.67968750 


.68359375 


.001 


.62524414 


.62915039 


.63305664 


.63696289 


.64086914 


.64477539 


.64868164 


.65258789 


.65649414 


.66040039 


.66430664 


.66821289 


.67211914 


.67602539 


.67993164 


.68383789 


.002 


.62548828 


.62939453 


.63330078 


.63720703 


.64111328 


.64501953 


.64892578 


.65283203 


.65673828 


.66064453 


.66455078 


.66845708 


.67236328 


.67626953 


.68017578 


.68408203 


.003 


.62573242 


.62963867 


.63354492 


.63745117 


.64135742 


.64526367 


.64916992 


.65307617 


.65698242 


.66088867 


.66479492 


.66870117 


.67260742 


.67651367 


.68041992 


.68432617 


.004 


.62597656 


.62988281 


.63378906 


.63769531 


.64160156 


.64550781 


.64941406 


.65332031 


.65722656 


.66113281 


.66503906 


.66894531 


.67285156 


.67675781 


.68066406 


.68457031 


.005 


.62622070 


.63012695 


.63403320 


.63793945 


.64184570 


.64575195 


.64965820 


.65356445 


.65747070 


.66137695 


.66528320 


.66918945 


.67309570 


.67700195 


.68090820 


.68481445 


.006 


.62646484 


.63037109 


.63427734 


.63818359 


.64208984 


.64599609 


.64990234 


.65000859 


.65771484 


.66162109 


.66552734 


.66943359 


.67333984 


.67724609 


.68115234 


.68505859 


.007 


.62670898 


.63061523 


.63452148 


.63842773 


.64233398 


.64624023 


.65014648 


.65405273 


.65795898 


.66186523 


.66577148 


.66967773 


.67358398 


.67749023 


.68139648 


.68530273 


.008 


.62695313 


.63085938 


.63476563 


.63867188 


.64257818 


.64648438 


.65039063 


.65429688 


.65820313 


.66210938 


.66601563 


.66992188 


.67382813 


.67773438 


.68164063 


.68554688 


.009 


.62719727 


.63110352 


.63500977 


.63891602 


.64282227 


.64672852 


.65063477 


.65454102 


.65844727 


.66235352 


.66625977 


.67016602 


.67407227 


.67797852 


.68188477 


.68579102 


.OOA 


.62744141 


.63134766 


.63525391 


.63916016 


.64306641 


.64697266 


.65087891 


.65478516 


.6586914) 


.66259766 


.66650391 


.67041016 


.67431641 


.67822266 


.68212891 


.68603516 


.OOB 


.62768555 


.63159180 


.63549805 


.63940430 


.64331055 


.64721680 


.65112305 


.65502930 


.65893555 


.66284180 


.66674805 


.67065430 


.67456055 


.67846680 


.68237305 


.68627930 


.OOC 


.62792969 


.63183594 


.63574219 


.63964844 


.64355469 


.64746094 


.65136719 


.65527344 


.65917969 


.66308594 


.66699219 


.67089844 


.67480469 


.67871094 


.68261719 


.68652344 


.OOD 


.62817383 


.63208008 


.63598633 


.63989258 


.64379883 


.64770508 


.65161133 


.65551758 


.65942383 


.66333008 


.66723633 


.671 14258 


.67504883 


.67895508 


.68286133 


.68676758 


.OOE 


.62841797 


.63232422 


.63623047 


.64013672 


.64404297 


.64794922 


.65185547 


.65576172 


.65966797 


.66357422 


.66748047 


.67138672 


.67529297 


.67919922 


.68310547 


.68701172 


.OOF 


.62866211 


.63256836 


.63647461 


.64038086 


.64428711 . 


f .64819336 


.65209961 


.65600586 


.65991211 


.66381836 


.66772461 


.67163086 


.6755371 1 


.67944336 


.68334961 


.68725586 


.000 


.BO 


.Bl 


.B2 


.B3 


.04 


.B5 


.B6 


.B7 


.68 


.B9 


.BA 


.BB 


.BC . 


.BD 


.BE 


.feP 


.68750000 


.69140625 


.69531250 


.69921875 


.70312500 


.70703125 


.71093750 


.71484375 


.71875000 


.72265625 


.72656250 


.73046875 


.73437500 


.73828125 


.74218750 » 


.74609375 


.001 


.68774414 


.69165039 


.69555664 


.69946289 


.70336914 


.70727539 


.71118164 


.71508780 


.71899414 


.72290039 


.72680664 


.73071289 


.73461914 


.73852539 


.74243164 


.74633789 


.002 


.68798828 


.69189453 


.69580078 


.69970703 


.70361328 


.70751953 


.71142578 


.71533203 


.71923828 


.72314453 


.72705078 


.73095703 


.73486328 


.73876953 


.74267578 


.74658203 


.003 


.68823242 


.69213867 


.69604492 


.69995117 


.70385742 


.70776367 


.71166992 


.71557617 


.71948242 


.72338867 


.72729492 


.73120117 


.73510742 


.73901367 


.74291992 


.74682617 


.004 


.68847656 


.69238281 


.69628906 


.70019531 


.70410156 


.70800781 


.71191406 


.71582031 


.71972656 


.72363281 


.72753906 


.73144531 


.73595156 


.73925781 


.74316406 


.74707031 


.005 


.68872070 


.69262695 


.69653320 


.70043945 


.70434570 


.70825195 


.71215820 


.71606445 


.71997070 


.72387695 


.72778320 


.73168945 


.73559570 


.73950195 


.74340820 


.74731445 


.006 


.68896484 


.69287109 


.69677734 


.70068359 


.70458984 


.70849609 


.71240234 


.71630859 


.72021484 


.72412109 


.72802734 


.73193359 


.73583984 


.73973609 


.74365234 


.74755859 


.007 


.68920898 


.69311523 


.69702148 


.70092773 


.70483398 


.70874023 


.71264648 


.71655273 


.72045898 


.72436523 


.72827148 


.73217773 


.73608398 


.73999023 


.74389648 


.74780273 


.008 


.68945313 


.69335938 


.69726563 


.70117188 


.70507813 


.70898438 


.71289063 


.71679688 


.72070313 


.72460938 


.72851563 


.73242188 


.73632813 


.74023438 


.74414063 


.74804688 


.009 


.68969727 


.69360352 


.69750977 


.70141602 


.70532227 


.70922852 


.71313477 


.71704102 


.72094727 


.72485352 


.72875977 


.73266602 


.73657227 


.74047852 


.74438477 


.74829102 


.OOA 


.68994141 


.69384766 


.69775391 


.70166016 


.70556641 


.70947266 


.71337891 


.71728516 


.72119141 


.72509766 


.72900391 


.73291016 


.73681641 


.74072266 


.74462891 


.74853516 


.OOB 


.69018555 


.69409180 


.69799805 


.70190430 


.70581055 


.70971680 


.71362305 


.71752930 


.Z2143555 


.72534180 


.72924805 


.73315430 


.73706055 


.74096680 


.74487305 


.74877930 


.OOC 


.69042969 


.69433594 


.69824219 


.70214844 


.70605469 


.70996094 


.71386719 


.71777344 


.72167969 


.72558594 


.72949219 


.73339844 


.73730469 


.74121094 


.74511719 


.74902344 


.OOD 


.69067383 


.69458008 


.69848633 


.70239258 


.70629883 


.71020508 


.71411133 


.71801758 


.72192383 


.72583008 


.72973633 


.73364258 


.73754883 


.74145508 


.74536133 


.74926758 


.OOE 


.69091797 


.69482422 


.69873047 


.70263672 


.70654297 


.71044922 


.71435547 


.71826172 


.72216797 


.72607422 


.72998047 


.73388672 


.73779297 


.74169922 


.74560547 


.74951172 


.OOF 


.69116211 


.69506836 


.69897461 


.70288086 


.70678711 


.71069336 


.71459961 


.71850586 


.72241211 


.72631836 


.73022461 


.73413086 


.73803711 


.74194336 


.74584961 


.74975586 



Section 1: General Information 1-65 



Decimal to Hexadecimal Conversion Information (cont'd) 



.000 


.CO 


.CI 


.C2 


.C3 


•C4 


.C5 


.C6 


.C7 


.C8 


.C9 


.CA 


.CB 


.CC 


• CD 


.CE 


.CF 


.75000000 


.75390625 


.75781250 


.76171875 


.76562500 


.76953125 


.77343750 


.77734375 


.78125000 


.78515625 


.78906250 


.79296875 


.79687500 


.80078125 


.80468750 


.80859375 


.001 


.75024414 


.75415039 


.75805664 


.76196289 


.76586914 


. 76977539 


.77368164 


.77758789 


.78149414 


.78540039 


. 78930664 


.79321289 


.79711914 


.80102539 


.80493164 


.80883789 


.002 


.75048828 


.75439453 


.75820078 


.76220703 


.76611328 


.77001953 


.77392578 


.77783203 


.78173828 


.78564453 


.78955078 


.79345703 


.79736328 


.80126953 


.80517578 


.80908203 


.003 


.75073242 


.75463867 


.75854492 


.76245117 


.76635742 


.77026367 


.77416992 


.77807617 


.78198242 


.78588867 


.78979492 


.79370117 


.79760742 


.80151367 


,80541992 


.80932617 


.004 


.75097656 


.75488281 


75878906 


.76269531 


.76660156 


.77050781 


.77441406 


.77832031 


.78222656 


.78613281 


.79003906 


.79394531 


.79785156 


.80175781 


.80566406 


.80957031 


.005 


.75122070 


.75512695 


.75903320 


.76293945 


.76684570 


.77075195 


.77465820 


.77856445 


.78247070 


.78637695 


.79028320 


.79418945 


.79809570 


.80200195 


.80590820 


.80981445 


.006 


.75146484 


.75537109 


. 75927734 


.76318359 


.76708984 


.77099609 


.77490234 


.77880859 


.78271484 


.78662109 


.79052734 


.79443359 


.79833984 


.80224609 


.80615234 


.81005859 


.007 


.75170898 


.75561523 


.75952148 


.76342773 


.76733398 


.77124023 


.77514648 


.77905273 


.78295898 


.78686523 


.79077148 


.79467773 


.79858398 


.80249023 


.80639648 


.81030273 


.008 


.75195313 


.75585938 


.75976563 


.76367188 


.76757813 


.77148438 


.77539063 


.77929688 


.78320313 


.78710938 


.79101563 


.79492188 


.79882813 


.80273438 


.80664063 


.81054688 


.009 


.75219727 


.75610352 


.76000977 


.76391602' 


.76782227 


.77172852 


.77563477 


.77954102 


.78344727 


.78735352 


.79125977 


.79516602 


.79907227 


.80297852 


.80688477 


.81079102 


.00 A 


.75244141 


.75634766 


.76025391 


.76416016 


.76806641 


.77197266 


.77587891 


.77978516 


.78369141 


.78759766 


.79150391 


.79541016 


.79931641 


.80322266 


.80712891 


.81103516 


.008 


.75268555 


.75659180 


.76049805 


. 76440430 


.76831055 


.77221680 


.77612305 


.78002930 


.78393555 


.78784180 


.79174805 


.79565430 


.79956055 


.80346680 


.80737305 


.81127930 


• 00C 


.75292969 


.75683594 


.76074219 


. 76464844 


.76855469 


. 77246094 


.77636719 


.78027344 


.78417969 


.78808594 


.79199219 


.79589844 


.79980469 


.80371094 


.80761719 


.81152344 


.000 


.75317383 


.75708008 


.76098633 


.76489258 


.76879883 


.77270508 


.77661133 


.78051758 


.78442383 


.78833008 


.79223633 


.79614258 


.80004883 


.80395508 


.80786133 


.81176758 


.00E 


.75341797 


.75732422 


.76123047 


.76513672. 


.76904297 


.77294922 


.77685547 


.78076172 


.78466797 


.78857422 


.79248047 


.79638672 


.80029297 


.80419922 


.80810547 


.81201172 


.OOF 


.75366211 


.75756836 


.76147461 


.76538086 


.76928711 


.77319336 


.77709961 


.78100586 


.78491211 


.78881836 


.79272461 


.79663086 


.80053711 


.80444336 


.80834961 


.81225586 


.000 


.DO 


.Dl 


.D2 


.03 


.04 


.D5 


. .D6 


. .D7 


.D8 


• D9 


.DA 


.DB 


.DC 


.DD 


.DE 


.DF 


.81250000 


.81640625 


.82031250 


.82421875 


.82812500 


.83203125 


.83593750 


.83984375 


.84375000 


.84765625 


.85156250 


.85546075 


.85937500 


.86328125 


.86718750 , 


.87109375 


.001 


.81274414 


.81665039 


.82055664 


.82446289 


.82836914 


.83227539 


.83618164 


.84008789 


.84399414 


.84790039 


.85180664 


.85571289 


.85961914 


.86352539 


.86743164 


.87133789 


.002 


.81298828 


.81689453 


.82080078 


.82470703 


.82861328 


.83251953 


.83642578 


.84033203 


.84423828 


.84814453 


.85205078 


.85595703 


.85986328 


.86376953 


.86767578 


.87158203 


.003 


.81323242 


.81713867 


.82104492 


.82495117 


.82885742 


.83276367 


.83666992 


.84057617 


.84448242 


.84838867 


.85229492 


.85620117 


.86010742 


.86401367 


.86791992 


.87182617 


.004 


.81347656 


.81738281 


.82128906 


.82519531 


.82910156 


.83300781 


.83691406 


.84082031 


.84472656 


.84863281 


.85253906 


.85644531 


.86035156 


.86425781 


.86816406 


.87207031 


.005 


.81372070 


.81762695 


.82153320 


.82543945 


.82934570 


.83325195 


.83715820 


.84106445 


.84497070 


.84887695 


.85278320 


.85660945 


.86059570 


.86450195 


.86840820 


.87231445 


.006 


.81396484 


.81787109 


.82177734 


.82568359 


.82958984 


.83349609 


.83740234 


.84130859 


.84521484 


.84912109 


.85302734 


.85693359 


.86083984 


.86474609 


.86865234 


.87255859 


.007 


.81420898 


.81811523 


.82202148 


.82592773 


.82983398 


.83374023 


.83764648 


.84155273 


.84545898 


.84936523 


.85327148 


.85717773 


.86108398 


.86499023 


.86889648 


.87280273 


.008 


.81445333 


.81835938 


.82226563 


.82617188 


.83007813 


.83398438 


.83789063 


.84179688 


.84570313 


.84960938 


.85351563 


.85742188 


.86132813 


.86523438 


.86914063 


.87304688 


.009 


.81469727 


.81860352 


.82250977 


.82641602 


.83032227* 


.83422852 


.83813477 


.84204102 


.84594727 


.84985352 


.85375977 


.85766602 


.86157227 


.86547852 


.86938477 


.87329] 02 


.00 A 


.81494141 


.81884766 


.82275391 


.82666016 


.83056641 


.83447266 


.83837891 


.84228516 


.84619141 


.85009766 


.85400391 


.85791016, 


.86181641 


.86572266 


.86962891 


.87353516 


.00B 


.81518555 


.81909180 


.82299805 


.82690430 


.83081055 


.83471680 


.83862305 


.84252930 


.84643555 


.85034180 


.85424805 


.85815430 


.86206055 


.86596680 


.86987305 


.87377930 


.OOC 


.81542969 


.81933594 


.82324219 


.82714844 


.83105469 


.83496094 


.83886719 


.84277344 


.84667969 


.85058594 


.85449219 


.85839044 


.86230469 


.86621094 


.87011719 


.87402344 


.OOD 


.81567383 


.81958008 


.82348633 


.82739258 


.83129883 


.83520508 


.8391 U33 


.84301758 


.84692383 


.85083008 


.85473633 


.85864258 


.86254883 


.86645508 


.87036133 


.87426758 


.00E 


.81591797 


.81982422 


.82373047 


.82763672 


.83154297 


.83544922 


.83935547 


.84326172 


.84716797 


.85107422 


.85498047 


.85880672 


.86279297 


.86669922 


.87060547 


.87451172 


.OOF 


.81616211 


.82006836 


.82397461 


.82788086 


.83178711 


.83569336 


.83959961 


.84350586 


.84741211 


.85131836 


.85522461 


r . 8591 3006 


.86303711 


.86694336 


.87084961 


.87475586 


.000 


.Go 

.87500000 


.El 
.87890625 


.17 
.88281250 


X3 
.88671875 


7t'4 
.89062500 


.E5 


.E6 


.E7 


.E8 


.E9 


.EA 


.EB 


.EC 


.ED 


.EE 


.EF 


.89453125 


.89843750 


.90234375 


.90625000 


.91015625 


.91406250 


.91796875 


.92187500 


.92578125 


.92968750 


.93359375 


.001 ' 


.87524414 


.87915039 


.88305664 


.88696289 


.89086914 


.89477539 


.89868164 


.90258789 


.90649414 


.91040039 


.91430664 


.91821289 


.92211914 


.92602539 


.92993164 


.93383789 


.002 


.87548828 


.87939453 


.88330078 


.88720703 


.89111328 


.89501953 


.89892578 


.90283203 


.90673828 


.91064453 


.91455078 


.91845703 


.92236328 


.92626953 


.93017578 


.93408203 


.003 


.87573242 


.87963867 


.88354492 


.88745117 


.89135742 


.89526367 


.89916992 


.90307617 


.90698242 


.91088867 


.91479492 


.91870117 


.92260742 


.92651367 


.93041992 


.93432617 


.004 


.87597656 


.87988281 


.88378906 


.88769531 


.89160156 


.89550781 


.89941406 


.90332031 


.90722656 


.91113281 


.91503906 


.91894531 


.92285156 


.92675781 


.93066406 


.93457031 


.005 


.87622070 


.88012695 


.88403320 


.88793945 


.89184570 


.89575195 


.89965820 


.90356445 


.90747070 


.91137695 


.91528320 


.91918945 


.92309570 


.92700195 


.93090820 


.93481445 


.006 


.87646484 


.88137109 


.88427734 


.88818359 


.89208984 


.89599609 


.89990234 


.90380859 


.90771484 


.91162109 


.91552734 


.91943359 


.92333984 


.9272460V 


.93115234 


.93505859 


.007 


.87670898 


.88061523 


.88452148 


.88842773 


.89233398 


.89624023 


.90014648 


.90405273 


.90795898 


.91186523 


.91577148 


.91967773 


.92358398 


.92749023 


.93139648 


.93530273 


.008 


.87695313 


.88085938 


.88476563 


.88867188 


.89257813 


.89648438 


.90039063 


.90429688 


.90820313 


.91210938 


.91601563 


.91992180 


.92382813 


.92773438 


.93164063 


.93554688 


.009 


.87719727 


.88110352 


.88500977 


.88891602 


.89282227 


.89672852 


.90063477 


.90454102 


.90844727 


.91235352 


.91625977 


.92016602 


.92407227 


.92797852 


.93188477 


.93579102 


.00A 


.87744141 


.88134766 


.88525391 


.88916016 


.89306641 


.89697266 


.90087891 


.90478516 


.90869141 


.91259766 


.91650391 


.92041016 


.92431641 


.92822266 


.93212891 


.93603516 


.008 


.87768555 


.88159180 


.88549805 


.88940430 


.89331055 


.89721680 


.90112305 


.90502930 


.90893555 


.91284180 


.91674805 


.92065430 


.92456055 


.92846680 


.93237305 


.93627930 


.OOC 


.87792969 


.88183594 


.88574219 


.88964844 


.89355469 


.89746094 


.90136719 


.90527344 


.90917969 


.91308594 


.91699219 


.92089044 


.92480469 


.92871094 


.93261719 


.93652344 


.OOD 


.87817383 


.88208008 


.88598633 


.88989258 


.89379883 


.89770508 


.90161133 


.90551758 


.90942383 


.91333008 


.91723633 


.92114258 


.92504883 


.92895508 


.93286133 


.93676758 


.OOE 


.87841797 


.88232422 


.88623047 


.89013672 


.89404297 


.89794922 


.90185547 


.90576172 


.90966797 


.91357422 


.91748047 


.92130672 


.92529297 


.92919922 


.93310547 


.93701172 


.OOF 
.000 


.87866211 


.88256836 


.88647461 


.89038086 


.89428711 


.89819336 


.90209961 


.90600586 


.90991211 


.91381836 


.91772461 


.92163006 


.92553711 


.92944336 


.93334961 


.93725586 


' .FO 


" .Pi 


• F2 


.F3 


.F4 


.F5 


.F6 


.F7 


.F8 


.F9 


.FA 


.FB 


.FC 


.FD 


.FE 


.FF 


.93750000 


.94140625 


.94531250 


.94921875 


.95312500 


.95703125 


.96093750 


.96484375 


.96875000 


.97265625 


.97656250 


.98046075 


.98437500 


.98828125 


.99218750 


.99609375- 


.001 


.93774414 


.94165039 


.94555664 


.94946289 


.95336914 


.95727539 


.96118164 


.96508789 


.96899414 


.97290039 


.97680664 


.98071209 


.98461914 


.98852539 


.99243164 


.99633789 


.002 


.93798828 


.94189453 


.94580078 


.94970703 


.95361328 


.95751953 


.96142578 


.96533203 


.96923828 


.97314453 


.97705078 


.90095703 


.98486328 


.98876953 


.99267578 


.99658203 


.003 


.93823242 


.94213867 


.94604492 


.94995117 


.95385742 


.95776367 


.96166992 


.96557617 


.96948242 


.97338867 


.97729492 


.98120117 


.98510742 


.98901367 


.99291992 


.99682617 


.004 


.93847656 


.94238281 


.94628906 


.95019531 


.95410156 


.95800781 


.96191406 


.96582031 


.96972656 


.97363281 


.97753906 


.98144531 


.98535156 


.98925781 


.99316406 


.99707031 


.005 


.93872070 


.94262695 


.94653320 - 


.95043945 


.95434570 


.95825195 


.96215820 


.96606445 


.96997070 


.97387695 


.97778320 


.98160945 


.98559570 


.98950195 


.99340820 


.99731445 


.006 


.93896484 


.94287109 


.94677734 


.95068359 


.95458984 


.95849609 


.96240234 


.96630859 


.97021484 


.97412109 


.97802734 


.98193359 


.98583984 


.98974609 


.99365234 


.99755859 


.007 


.93920898 


.94311523 


.94702148 . 


.95092773 


.95483398 


.95874023 


.96264648 


.96655273 


.97045898 


.97436523 


.97827148 


.90217773 


.98608398 


.98999023 


.99389648 


.99780273 


.008 


.93945313 


.94335938 


.94726563 


.95117188 


.95507813 


.95898438 


.96289063 


.96679688 


.97070313 


.97460938 


.97851563 


.98242188 


.98632813 


.99023438 


.99414063 


.99804688 


.009 


.93969727 


.94360352 


.94750977 


.95141602 


.95532227 


.95922852 


.96313477 


.96704102 


.97094727 


.97485352 


.97875977 


.90266602 


.98657227 


.99047852 


.99438477 


.99829102 


.00 A 


.93994141 


.94384766 


.94775391 


.95166016 


.95556641 


.95947266 


.96337891 


.96728516 


.97119141 


.97509766 


.97900391 


.98291016 


.98681641 


.99072266 


.99462891 


.99853516 


.OOB 


.94018555 


.94409180 


.94799805 


.95190430 


.95581055 


.95971680 


.96362305 


.96752930 


.97143555 


.97534180 


.97924805 


.98315430 


.98706055 


.99096680 


.99487305 


.99877930 


.OOC 


.94042969 


.94433594 


.94824219 


.95214844 


.95605469 


.95996094 


.96386719 


.96777344 


.97167969 


.97558594 


.97949219 


.98339044 


.98730469 


.99121094 


.99511719 


.99902344 


.OOD 


.94067383 


.94458008 


.94848633 


.95239258 


.95629883 


.96020508 


.96411133 


.96801758 


.97192383 


.97583008 


.97973633 


.98364250 


.98754883 


.99145508 


.99536133 


.99926758 


.OOE 


.94091797 


.94482422 


.94873047 


.95263672 


.95654297 


.96044922 


.96435547 


.96826172 


.97216797 


.97607422 


.97998047 


.90300672 


.98779297 


.99169922 


.99560547 


.99951172 


.OOF 


.94116211 


.94506836 


.94897461 


.95288086 


.95678711 _ 


-.96069336 


.96459961 


.96850586 


.97241211 


.97631836 


.98022461 


.98413086 


.98803711 


.99194336 


.99584961 


.99975586 



1 -66 0S/VS1 Programmer's Reference Digest 



Extended Binary Coded Decimal Interchange Code (EBCDIC) 

Extended Binary-Coded-Decimal Interchange Code (EBCDIC) 

The following 256-position table, outlined by the heavy black lines, shows the graphic characters and 
control character representations for EBCDIC. The bit-position numbers, bit patterns, hexadecimal 
representations and card hole patterns for these and other possible EBCDIC characters are also shown. 
To find the card hole patterns for most characters, partition the 256-position table into four blocks 
as follows: 



3 

2 

4 



Block 1 



Zone punches at top of table; 

digit punches at left 

Zone punches at bottom of table; 

digit punches at left 

Zone punches at top of table; 

digit punches at right 

Zone punches at bottom of table; 

digit punches as right 



Fifteen positions in the table are exceptions to the above arrangement. These positions are indicated 
by small numbers in the upper right corners of their boxes in the table. The card hole patterns for 
these positions are given at the bottom of the table. Bit-position numbers, bit patterns, and hexa- 
decimal representations for these positions are found in the usual manner. 
Following are some examples of the use of the EBCDIC chart: 



Character 


Type 


Bit Pattern 


Hex 


■ Hole Pattern 


Zone Punches 


Digit Punches 


PF 


Control Character 


00 00 0100 


04 


12-9-4 


% 


Special Graphic 


01 10 1100 


6C 


0-8-4 


R 


Upper Case 


11 01 1001 


D9 


11 - 9 


a 


Lower Case 


10 00 0001 


81 


12-0- 1 




Control Character, 
function not yet 
assigned 


00 1 1 0000 


30 


12-11-0-9-8-1 

1 
1 



Bit Positions 
01 23 4567 



Section 1: General Information 1-67 



Extended Binary Coded Decimal Interchange Code (EBCDIC) (cont'd) 

EBCDIC Codes 



* s 


00 


01 


10 


11 




Bit Positions 0,1 


-o "3 
«n E 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


Bit Positions 2,3 


§2-5 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


c 


D 


E 


F 


First Hexadecimal Digit 


12 








12 


12 




12 


12 


12 




12 


12 










"S TJ «E 

42 § -a 




11 








11 


11 


11 




11 


11 


11 




11 
















































Digit ranches 


CO 


JL 


" 


9 


9 


9 


9 


9 


9 


9 


9 


































© 


© 


© 


© 


© 


© 


© 


© 










© 


© 


© 


© 






0000 





8-1 


NUL 


DLE 


DS 




SP 


& 


" 

























0001 


1 


1 


SOH 


DC1 


SOS 








/& 




a 


j 






A 


J 


(14) 


1 


1 




0010 


2 


2 


STX 


DC2 


FS 


SYN 










b 


k 


s 




B 


K 


S 


2 


2 




0011 


3 


3 


ETX 


TM 














c 


1 


t 




C 


L 


T 


3 


3 




0100 


4 


4 


PF 


RES 


BYP 


PN 










d 


m 


u 




D 


M 


U 


4 


4 




0101 


5 


5 


HT 


NL 


LF 


RS 










e 


n 


V 




E 


N 


V 


5 


5 




0110 


6 


6 


LC 


BS 


ETB 


UC 










f 


o 


w 




F 


O 


w 


6 


6 




0111 


7 


7 


DEL 


IL 


ESC 


EOT 










9 


P 


x 




G 


P 


X 


7 


7 




1000 


8 


8 




CAN 














h 


q 


y 




H 


Q 


Y 


8 


8 




1001 


9 


8-1 




EM 














i 


r 


z 




1 


R 


z 


9 


9 




1010 


A 


8-2 


SMM 


CC 


SM 




<? 


1 


© 




















8-2 




1011 


B 


8-3 


VT 


CU1 


CU2 


CU3 




$ 


, 


« 


















8-3 




1100 


C 


8-4 


FF 


IFS 




DC4 


< 




% 


@ 


















8-4 




1101 


D 


8-5 


CR 


IGS 


ENQ 


NAK 


( 


) 




' 


















8-5 




1110 


E 


8-6 


SO 


IRS 


ACK 




+ 


; 


> 


= 


















8-6 




1111 


F 


8-7 


SI 


IUS 


BEL 


SUB 


1 


— i 


? 


" 


















8-7 






12 








12 








12 


12 




12 


12 


12 




12 










11 








11 








11 


11 


11 




11 


11 


11 




















































9 


9 


9 


9 


















9 


9 


9 


9 




Cord Hole Patterns 
















© 12-0-9-8-1 


© No Punches 


3>12 


-0 


© 


0-1 




© 12-11-9-8-1 


©12 ( 


"0) 11 


-0 


• (H) 


11-0-9-1 




© H-0-9-8-1 


®" ( 


1) 0- 


8-2 


® 


12-11 




12-11-0-9-8-1 


©12-11-0 ( 


j) ° 










Control Character Represent 


ations 






Spec 


ial Graphic Characters 




ACK Acknowledge 


EOT End of Transmission 


PF 


Punch Off 


C 


Cent Sign 


Minus Sign, Hyphen 


BEL Bell 


ESC Escape 


PN 


Punch On 




Period, Decimal Point 


/ Slash 


BS Backspace 


ETB . End of Transmission Block 


RES 


Restore 


< 


Less-than Sign 


, Comma 


BYP Bypass 


ETX End of Text 


RS 


Reader Stop 


( 


Left Parenthesis 


% Percent 


CAN Cancel 


FF Form Feed 


SI 


Shift In 


+ 


Plus Sign 


Underscore 


CC Cursor Control 


FS Field Separator 


SM 


Set Mode 


1 


Logical OR 


> Greater-than Sign 


CR Carriage Return 


HT Horizontal Tab 


SMM 


Start of Manual 


& 


Ampersand 


? Question Mark 


CU1 Customer Use 1 


IFS Interchange File Separator 




Message 


1 


Exclamation Point 


Colon 


CU2 Customer Use 2 


IGS Interchange Group Separator 


SO 


Shift Out 


$ 


Dollar Sign 


' Number Sign 


CU3 Customer Use 3 


IL Idle 


SOH 


Start of Heading 


* 


Asterisk 


@ At Sign 


DC1 Device Control 1 


IRS Interchange Record Separator 


SOS 


Start of Significanc 


• ) 


Right Parenthesis 


' Prime, Apostrophe 


DC2 Device Control 2 


IUS Interchange Unit Separator 


SP 


Space 


; 


Semicolon 


= Equal Sign 


DC4 Device Control 4 


LC Lower Case 


STX 


Start of Text 


1 


Logical NOT 


" Quotation Mark 


DEL Delete 


LF Line Feed 


SUB 


Substitute 








DLE Data Link Escape 


NAK Negative Acknowledge 


SYN 


Synchronous Idle 








DS Digit Select 


NL New Line 


TM 


Tape Mark 








EM End of Medium 


NUL Null 


UC 


Upper Case 








ENQ 


Enqui 


y 
















VT 


Verti 


cal Tab 





















1 -68 OS/VS1 Programmer's Reference Digest 



System 2: System Information 



Save Area Format 2-2 

Trace Table 2-3 

System/370 Operating System Register Usage 2-4 

Linkage Register Conventions 2-5 
, UCB Sense Information 2-6 
" Device Statistics Table 2-16 

Device Allocation for New Data Sets 2-19 

Completion Code Summary 2-20 

Wait State Codes 2-30 

System ENQ/DEQ Names 2-32 

How to Find 2-33 



Source Publications 



Additional information about linkage registers is in OS/VS1 Supervisor 
Services and Macro Instructions, GC24-5103. 

You can obtain additional information about the devices referenced 
from the publication on the theory of operations or operating pro- 
cedures. Refer to the IBM System/ 360 and System/ 370 Bibliography, 
GA22-6822 for a list of these publications. 

You can obtain additional information about completion codes from 
OS/ VS Message Library: VS1 System Codes, GC38-1003. 



Section 2: System Information 2-1 



Save Area Format 





1 Next higher save area ) 





4 


\ J Next lower save area 


Register 14 K 


8 


12(C) 


Register 15 


Contents of \ 


registers 0-12 



16(10) 



Bytes 4-7: 



20(14) 



Pointer to the next higher level save area or, if this is the 
highest level save area, zeros. 



Bytes 8-1 1(B): Pointer to the next lower level save area or, if this is the lowest 

level save area, unused. 

Bytes 12-15(C-F): Contents of register 14 (optional) 

Bytes 16-19(10-13): Contents of register 15 (optional) 

Bytes 20-71(14-3F): Contents of registers to 12 



2 • 2 OS/VS 1 Programmer's Reference Digest 



Trace Table 

HOW TO USE TRACE TABLE 

The tracing routine is an optional feature specified during system generation. Inclusion 
of this routine (and the size of the trace table) is effected by specifying, in the 
CTRLPROG macro, TRACE= a number greater than zero. The trace routine is disabled 
when GTF (generalized trace facility) is started and is enabled when GTF is stopped. 

The trace routine places entries, each of which is associated with a certain type of 
event, into a trace table. When the table is filled, the routine overlays old entries with 
new entries, beginning at the top of the table (the entry having the lowest address). 

Location X'14' or location X'54' points to pertinent trace table addresses: 

3 4 7 8 11 



Current 

Table 

Entry 


Beginning 
of Trace 
Table 


End of 
Trace Table 
+lByte 



lfX'14' is other than X'OO', the internal trace table is disabled. (In a stand-alone dump, 
location X'14 1 is overlaid. If its content is desired, it should be displayed prior to tak- 
ing the dump.) 

Trace table entries are 18 (decimal) bytes long and represent occurrences of SIO, I/O, 
SVC, and DSP (task switch) interruptions. The first digit in byte 16 identifies the entry 
type. 

SIO Instruction 



CC/Dev 


CAW 


CSW 


3x 





I/O Interruptic 



I/O OLD PSW 


CSW 


2 ! I/O Addr 
i 1 



SVC Interruption 



SVC OLD PSW 


RegO 


Reg 1 


00 


SVC No . 
in Hex 



Dispatched PSW 


NEWTCB 


OLD TCB 


lx 





Section 2: System Information 2-3 



Register Usage - How to Find 

SYSTEM/370 OPERATING SYSTEM REGISTER USAGE 



General 






Open/ 


Fetch, Link, 


Register 


Supervisor 


IPS 


Close/EOV 


XCTL, Load 




1 




@TCB 
@RQE 


Work/Par 
Work/Par 




2 




@IOB 


DCB/ACB 


©Linkor's RB 


3 


@CVT 


@DEB 


Base 


@CVT 


4 


@TCB 


@DCB 


@Work Area 


@TCB 


5 


@RB 


Base 


@Par List 


@SVRB 


6 


@svc 


Unit Addr 


©WTG 


©Work 


7 




@UCB 


©Curr Par 


Base 


8 




Base 


©Curr WTG 


Return 


9 




Char 


@TIOT 


Branch 


10 




Work 


@UCB 


©Linkee's RB 


11 




Work 




©Work 


12 




Work/Link 




©Linkee's Name 


13 




Log Ch Wd 






14 


@T1 Exit 


Link 






15 




Appn Base 







Note: Reg 2 does not always point to the DCB/ACB for OPEN/CLOSE/EOV. (Work 
register for DADSM and CATALOG .) 





Symbol 


Save Sequence User 




lORGSAV 

PDSAV 

PISAV 

SVCSAV 

lEAEXSAV 


2-9 
10-1 
10-9 
0-15 
2-9 


IO FLIH 

IO FLIH and Ext FLIH 

PC FLIH 

SVC FLIH 

EXT FLIH 


HOW TO FIND 






lORGSAV: Location 7D (address portion of I/O new PSW) contains the address of I/O 
FLIH. The two-byte ADCON of lORGSAV is located 10 bytes from the entry point. 


PDSAV 


lORGSAV + 20 (hex). 






PISAV: lORGSAV + 40 (hex) . 






lEAEXSAV: lORGSAV. 






SVCSAV: 


lORGSAV + 90 (hex), 






DSPPSW: 


(Dispatch Resume PSW) SVCSAV 


+ 40 (hex 


)• 


TCBSAV: 


(Registers saved and restored for d 


'spatch in 


TCB) Saved Reg. 10 through 



Reg. 9 in TCB + 30 (hex). 



2-4 OS/VS1 Programmer's Reference Digest 



Linkage Register Conventions 



Linkage 


Register Conventions 


Reg 


Use 





Posses parameters to the control program or the called program. 




Parameter type depends on macro type. 


1 


Passes parameters or the address of a parameter list to the control 




progrcm, or passes parameters to the called program. Parameter 




type depends on macro type. 


2-12 


Worlc registers: not changed by the control program. 


13 


Passes the address of the register tave area provided by the 




calling program. 


14 


Passes the return address to the calling program or the control 




program . 


15 


Contains the entry-point address, the address of a parameter list 




as the result of using certain macros, or the rerurn code. 



Section 2: System Information 2-5 



UCB Sense Information 



\ BIT 

DEVICr\^ 





1 


2 


3 


4 


5 


6 


7 


1052 


CMD 
REJ 


INT 

REQ 


BUS 
OUT 


EQ 
CHK 




1287 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1288 


CMD 
REJ 


INT 

REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 




1403 
1443 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA/ 
CHK/ 

/type 

/ BAR 


STR / 
PTY / 

err/ 
/type 

/ BAR 




CH 9 


1442, 2501, 
2520, 2596 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




1419/1275 
PCU 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 




DATA 
CHK 


OVER- 
RUN 


AUTO 
SELECT 


1419/1275 
SCU 


CMD 
REJ 


INT 
REQ 


BUS OUT 
CHK 




DATA 
CHK 


OVER- 
RUN 


AUTO 
SELECT 


2250 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


BUFFER 
RUN- 
NING 


2260 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 








2305 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


2314,2319 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


TRK 

COND 

CHK 


SEEK 
CHK 


2400 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WRD 
CNT 
ZERO 


DATA 
CNVT 
CHK 


2495 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


POSN 
CHK 


SHOULD 

NOT 

OCCUR 


2540 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 




UN- 
USUAL 
CMD 




2671, 2822 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 




3210, 3215 


CMD 
REJ 


INT 
REQ 




EQ 
CHK 




3211 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


BUFFER 
PARITY 
CHK 


LOAD 
CHK 


CH9 


3330, 3333 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 





2-6 OS/VS1 Programmer's Reference Digest 



UCB Sense Information (cont'd) 



\ BIT 
DEVICE^. 





1 


2 


3 


4 


5 


6 


7 


3330-1 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 






3340 


CMD 
REJ 


INT 

REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


TRK 

COND 

CHK 


SEEK 
CHK 


3410, 3411 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WRD 
CNT 
ZERO, 




3420, 3803 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

COUNT 

ZERO 


DATA 
CNVT 
CHK 


3505, 3525 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 




ABN 

FORMAT 

RESET 


PERM 
ERR 

(BYPASS 
KEY) 


388"6 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 






NON 
INIT 


RCP 
ERR 


3890 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 




NON 
INIT 


RUN- 
NING 



\w BIT 

DEVICE^^ 





1 


2 


3 


4 


5 


6 


7 


1287 


TAPE 
MODE 


LATE 
STKR 
SELECT 


NO 
DOC 
FOUND 




INVAL 
OP 




1288 




END 

OF 

PAGE 


NO 
DOC 
FOUND 


INVAL 
OP 


1419/1275 
SCU 


FLD6 
VALID 


FLD7 
VALID 


DOC 

UNDER 

WHD 


AMT 
FLD 
VALID 


PRO 

CTL FLD 
VALID 


ACCT* 

FLD 

VALID 


TRANSIT 

FLD 

VALID 


SER' 
FLD 
VALID 


2250 


LIGHT 

PEN 

DETECT 


END 

ORDER 

SEQ 


CHAR 
MODE 












2260 








2305 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 


NO 
REC 
FOUND 


FILE 
PROT 


OPER- 
ATION 
INC 


2314, 2319 


DATA 
CHK IN 
COUNT 


TRK 
OVER- 
FLOW 


END 

OF 

CYL 


INVAL 
SEQ 


NO 
REC 
FOUND 


FILE 
PROT 


SERVICE 
OVER- 
RUN 


OVER- 
FLOW 
INL 



Section 2: System Information 2-7 



UCB Sense Information (cont'd) 



"^\BIT 
DEVICE^., 





1 


2 


3 


4 


5 


6 


7 


2400 


NOISE 


00-NON-XST TU 
01-NOT READY 
10-RDY & NO RWD 
ll-RDY&RWDING 


7 TRK 


AT 

LOAD 

POINT 


WRT 
STATUS 


FILE 
PROT 


TAPE 
IND 


3211 


CMD 
RETRY 


PRINT 
CHK 


PRINT 
QUALITY 


LINE 
POS 


FORMS 
CHK 


CMD 
SUP 


MECHAN- 
ICAL 
MOTION 




3330, 3333 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 


STATE 

VAR 

PRES 


NO 
REC 
FOUND 


FILE 
PROT 


WRITE 
INHIBIT 


OPER- 
ATION 
INL 


3330-1 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 




NO 
REC 
FOUND 


FILE 
PROT 


WRITE 
INHIBIT 


OPER- 
ATION 
INC 


3340 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 




NO 
REC 
FOUND 


FILE 
PROT 


WRITE 
INHIBIT 


OPER- 
ATION 
INC 


3410, 3411 


NOISE 


TU 

STAT 

A 


TU 

STAT 

B 




AT 

LOAD 

POINT 


WRT 
STAT 


FILE 
PROT 


NOT 
CAPA- 
BLE 


3420, 2803 


NOISE 


TU 

STAT 

A 


TU 

STAT 

B 


7 TRK 


AT 

LOAD 

POINT 


WRT 
STAT 


FILE 
PROT 


NOT 
CAPA- 
BLE 


3505, 3525 


PERM 
ERR 


AUTO 
RETRY 


MOTION 
MAL 


RETRY 
AFTER 
INT REQ 
COMP 










3886 




MARK 
CHECK 


INVLD 
FORMAT 




INCOMP 
SCAN 




NON 
RECOV- 
ERY 


OUT- 
BOARD 



^\s. BIT 

DEVICE\^ 





1 


2 


3 


4 


5 


6 


7 


2250 




BIT 15 


BIT 14 


BUFFER ADDRESS 
BIT 13 1 BIT 12 


REGISTER 
BIT 11 


BIT 10 |BiT 9 


2260 




BIT 15 


BIT 14 


BUFFER ADDRESS R 
BIT 13 1 BIT 12 


EGISTER 
BIT 11 


BIT 10 j BIT 9 


2305 


BUF 
LOG 
FULL 


COR- 
RECT- 
ABLE 










2314, 2319 


UNSAFE 




SER/ 
DESER 


TAG 
LINE 


ALU 
CHK 


UNSEL 
STATUS 


2400 


BITS0 


-7INDIC 


ATE A TR* 


CK IS IN ERROR 




6 & 7 INDICATE 
NO ERROR OR 
MULTI-ERROR 


3211 


CARR 
FAILED 
TO 
MOVE 


CARR 
SEQ 


CARR 
STOP 


PLATEN 
FAILED 


PLATEN 
FAILED 


FORMS 
JAM 


RIBBON 
MOTION 


TRAIN 
OVER- 
LOAD 



2-8 OS/VS1 Programmer's Reference Digest 



UCB Sense Information (cont'd) 



"\^^ BIT 

device"\^ 





1 


2 


3 


4 


5 


6 


7 


3330, 3333 




COR- 
RECT- 
ABLE 




ENV 
DATA 
PRESENT 




3330-1 




COR- 
RECT- 
ABLE 




ENV 
DATA 
PRESENT 










3340 


RPS 
FEA- 
TURE 


COR- 
RECT- 
ABLE 




ENV 
DATA 
PRESENT 






MODULE 
SIZE 


MODULE 
SIZE 


3410, 3411 


TRACK IN ERROR BITS 


3420, 3B03 


TRACK IN ERROR BITS 


3505, 3525 


USED FOR DIAGNOSTIC PURPOSES ONLY 


BYTE 3 


^*\^ BIT 

DEVICE\. 





1 


2 


3 


4 


5 


6 


7 


2250, 2260 


Bit 8 


• 1.7 


BUFFER ADDRESS RE 
Bit 6 1 8if5 [Bit 4 


GISTER 

n.3 


.», 


Bit 1 


2305 


RESTART COMMAND 


2314 


BUSY 


ON 
LINE 


UNSAFE 


WR 
CUR 
CFN 


PACK 
CHNG 


END 

OF 

CYL 


M-MODE 
SE 


SEEK 
INC 


2319 


LRC 
BIT0 


LRC 
BIT 1 


LRC 
BIT 2 


LRC 
BIT 3 




2400 


R/W 
VRC 


LRCR 


SKEW 


CRC 


SKEW 
REQ 


0-1600 
1-800 


BKWD 
STATUS 


COM- 
PARE 


3211 


UCSB 
PARITY 


PLB 
PARITY 


FCB 
PARITY 


COIL 
PROT 
CHK 


HAM- 
MER 
FIRE 


FIELD 
ENG 


USCAR 
SYNC 
CHK 


SEP 

SYNC 

CHK 


3330, 3333 


RESTART COMMAND 


3330-1 


RESTART COMMAND 


3340 


RESTART COMMAND 


3410, 3411 


R/W 
VRC 


MTE/ 
LRCR 


SKEW 


END 
DATA 
CHK/CRC 


ENV 
CHK 


1600 
BPI 
IN TU 


BKWD 




3420, 3803 


R/W 
VRC 


MTE/ 
LRC 


SKEW 


END 
DATA 
CHK/CRC 


VRC/ 
ENV 
CHK 


1600 
BPI 


BKWD 


COM- 
PARE 


3505, 3525 


USED FOR DIAGNOSTIC PURPOSES ONLY 



Section 2: System Information 2-9 



UCB Sense Information (cont'd) 



^\. BIT 

DEVICE-^ 





1 


2 


3 


4 


5 


6 


7 


2250, -2260 




2305 






2314 




PHYSICAL 

DRIVE ID 


2319 


SEQ 
INDO 


SEQ 
IND 1 


SEQ 
IND 2 


SEQ 
IND 3 


SEQ 
IND 4 


SEQ 
IND 5 


SEQ 
IND 6 


SEQ 
IND 7 


2400 


ECHO 
ERR 


RES 

TAPE 

UNIT 


READ 
CLOCK 

ERR 


WRITE 
CLOCK 

ERR 


DELAY 
CNTR 


SEQ 
INDC 


SEQ 
IND B 


SEQ 
IND A 


3211 




3330, 3333 


PHYSICAL DRIVE IDENTIFICATION 


3330-1 


PHYSICAL DRIVE IDENTIFICATION 


3340 


PHYSICAL DRIVE IDENTIFICATION 


3410, 3411 


TU 

POSIT 

CHK 


REJ 

TAPE 

UNIT 


EOT 




DIAG 

TRK 

CHK 


TU 
CHK 


SPARE 


3420, 3803 


ALU 

HDWR 

ERROR 


REJ 

TAPE 

UNIT 


TAPE 
INDI- 
CATE 


WRITE 
TRGGR 
VRC 


MICRO- 
PGM DET 
ERROR 


LWR 
ERROR 


TAPE 
UNIT 
CHK 


RES 
RPQ 



^s. BIT 

DEVICE"\ 





1 


2 


3 


4 


5 


6 


7 


2250, 2260 




2305 


CYLINDER ADDRESS 


2314 


COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 


2319 




2400 


COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
OR ZERO 


3211 




3330, 3333 


CYLINDER ADDRESS 


3330-1 


CYLINDER ADDRESS 


3340 


CYLINDER ADDRESS 


3410, 3411 


NEW 
SUB- 
SYSTEM 


NEW 
SUB- 
SYSTEM 


WRT 
TM 
CHK 


PE ID 
BURST 


PRTY 
COMP 


TACH 
CHK 


FALSE 

END 

MARK 


RPQ 


3420, 3803 


NEW 
SUB- 
SYSTEM 


NEW 
SUB- 
SYSTEM 


WRT 
TM 
CHK 


PE ID 
BURST 


START 
READ 
CHK 


PARTIAL 
RECORD 


XCESSVE 
PSTAMBL 
ORTM 


RES 
RPQ 



2-10 OS/VS1 Programmer's Reference Digest 



UCB Sense Information. (cont'd) 



"\bit 

DEVICE\ 





1 


2 


3 


4 


5 


6 


7 


2305 


CURRENT HEAD ADDRESS 


3330, 3333 


REVERSE 


CYL 
HIGH 


DIFFER 
HIGH 


HEAD ADDRESS 


3330-1 




CYL 
512 


CYL 
256 


HEAD ADDRESS 


3340 


RE- 
VERSE 


CYL 
HIGH 


DIFFER 
HIGH 


HEAD ADDRESS 


3410, 3411 




SHRT 
GAP 


DUAL 
DENSITY 


ALT 
DENSITY 


TAPE UNIT MODEL 


3420, 3803 


7TRK 


WRT 


DUAL 


NRZI 


TAPE UNIT MODEL DEFINED 



\. BIT 

DEVICE^^ 





1 


2 


3 


4 


5 


6 


7 


2305 


• ENCODED ERROR MESSAGE 


3330, 3333 


FORMAT OF REMAINING 
SENSE BYTES (8-23) 


ENCODED ERROR MESSAGE 


3330-1 


FORMAT OF REMAINING 
SENSE BYTES (8-23) 


ENCODED ERROR 
MESSAGE 


3340 


FORMAT OF REMAINING 
SENSE BYTES (8-23) 


ENCODED ERROR 
MESSAGE 


3410, 3411 


LAMP 
CHK 


LEFT 
COL 
CHK 


RT 

COL 

CHK 


RESET 
KEY 


DATA 

SEC 

ERASE 




3420, 3803 


LAMP 
FAIL 


TAPE 

BOTTOM 

LEFT 


TAPE 

BOTTOM 

RIGHT 


RESET 
KEY 


DATA 
SCRTY 
ERASE 


ERASE 
HEAD 
FAILED 


AIR 

BRNG 

PRESS 


LOAD 
FAIL 



^^_ BIT 

DEVICE\ 





. 1 


2 


3 


4 


5 


6 


7 


3410, 3411 




WRT 
FEED 
THRU 
CHK 




END 
VEL 
CHK 


RDBK 
DATA 
NOT 
DET 


START 

VEL 

CHK 




MAR- 
GINAL 
VELOC 


3420, 3803 


IRG 
DROP 
IN WRT 


FEED 
THRU 
CHK 


SDR 
CNTR 


EARLY 

BGNRD 

BKCHK 


EARLY 

ENDRD 

BKCHK 


SLOW 

BGNRD 

BKCHK 


SLOW 

ENDRD 

BKCHK 


VELO 

RETRY/ 

RESTRT 



Section 2 : System Information 2-11 



UCB Sense Information (cont'd) 



DEVICE'^ 





1 


2 


3 


4 


5 


6 


7 


3420, 3803 


JDR 
CNTR 


VLCTY 
CHNG 
ONWRT 


SDR COUNTERS 




TAPE 
CTL 
RESD 


BYTE 10 


DEVICE^s^ 





1 


2 


3 


4 


5 


6 


7 


3420, 3803 


CMD 

STATUS 

REJ 




CNTRL 
STATUS 
REJ 


NOBLK 
ON RCD 
RD BKCK 


WTM 
NOT 
DETECT 


TACH 
START 
FAIL 




VELO- 
CITY 
CHK 


BYTE 1 1 


^\bit 

DEVICE\^ 





1 


2 


3 


4 


5 


6 


7 


3420, 3803 


BBUS 
PARITY 
ALU 1 




LO ROS/ 
LO IC 
PARITY 


HI IC 
BRCOND 
/HI ROS 


MCPGM 
DET 
HDWR 
ERR 


DBUS 
PARITY 
ALU 1 




BR 

COND 
ALU 1 



2-12 OS/ VS 1 Programmer's Reference Digest 



UCB Sense Information (cont'd) 



Byte 12 



\. BIT 

DEVICE-^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


BBUS 
PAR ERR 
ALU 2 




LO ROS/ 
LOIC 
ON BR 


HI IC 
BR/HI 
ROS REG 


MCPGM 
DETECT 
HDWR ERR 


DBUS 
PARITY 
ALU 2 




BR 

COND 
ALU 2 











Byte 13 










\^ BIT 

DEVICE-^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


CONTROL 

UNIT 

DENSITY 


CONTROL UNIT UNIQUE 
ID- HIGH ORDER 



>v \ BIT 


















DEVICE^ 





1 


2 


3 


4 


5 


6 


7 


3420, 


CONTROL UNIT UNIQUE 












3803 


ID - LOW ORDER 













\ BIT 


















DEVICE^. 





1 


2 


3 


4 


5 


6 


7 


3420, 




TAPE UNIT UNIQUE ID - 










3803 




HIGH ORDER 











Section?: Systeni Information 2-13 



UCB Sense Information (cont'd) 



Byte 16 



\^ BIT 

DEVICE-*. 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


TAPE UNIT UNIQUE ID - 
LOW ORDER 



Byte 17 



\. BIT 

DEVICE^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


2 

CHAN 

SWTCH 


CONTROL UNIT 
WITH DEVICE 
SV/ITCH FEATURES 


EC LEVEL OF 

TAPE CONTROL UNIT 



\ BIT 
DEVICE-^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


POWR 
CHK/ 
AIRFLO 




EC LEVEL OF 
TAPE UNIT 



Byte 1? 



V \ > BIT 

DEVICE^. 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


PRIMED FOR DEVICE END 
TU7 1 TU6 1 TU5 J TU 4 1 TU 3 1 TU 2 1 TU 1 1 TU 



2-14 OS/VS 1 Programmer's Reference Digest 



UCB Sense Information (cont'd). 













Byte 20 










\^ BIT 

DEVICE^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


TUF 


PRIMED FOR DEVICE END 
TU E 1 TU D 1 TU C 


TU B 


TUA 


TU9 


TU8 



^\ BIT 

DEVICE--. 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


LOAD 

BUTTON 

DEPRESS 


LEFT 
REEL 
TRNG 


RIGHT 

REEL 

TRNG 


TAPE 
PRESENT 


REELS 
LOADED 


LOAD 
REWIND 


LOAD 
COM- 
PLETE 


LOAD 
CHK 



Byte 22 



\^ BIT 

DEVICE-^ 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


FRU IDENTIFIERS FOR ALU 1 













Byte 23 










"^\ BIT 

DEVICE^. 





1 


2 


3 


4 


5 


6 


7 


3420, 
3803 


FRU IDENTIFIERS FOR ALU 2 



Section 2: System Information 2-15 



Device Statistics Table 

The device statistics table contains counters that are used to keep track of the number 
of times error conditions have occurred on I/O devices. It is used by IBM-supplied 
error routines and the statistical data records (SDR) of SER. This table is created at 
system generation and resides in the fixed nucleus. It contains a ten byte control 
field, used in locating entries to be updated, at the beginning of the table and, 
with the exceptions noted below, one ten byte entry for each I/O device in a 
system. The devices UCB points to the entry. The exceptions are: 



1 ten byte entry is pointed to by each UCB 



• 2305 Model 1 and 2 - one 
in a bank. 

• 2314 - A 2314 is considered to be nine devices. Therefore, one common 90- 
byte entry is pointed to by each 2314 UCB in a bank. 

• 2400 tape drives - the entry is 20 bytes if and only if DDR (dynamic device 
reconfiguration) and a 3400 tape drive are in the system. 

• 3330 - one ten byte dummy entry is pointed to by all 3330 UCBs in a bank. 
° 3340 - One ten byte dummy entry is pointed to by all UCBs in a bank. 

• 3410, 3420 tape drives - entry is 20 bytes long; bit 3 in UCBFL5 is on in its 
UCB. 

• 3886 entry is 30 bytes long; bit 3 in UCBFL5 is on in its UCB. 

The UCB pointers in the control field are used to determine the section of the table 
in which the desired entry is located. If the desired entry is in other than section 
1, a multiple of 256 (256 for section 2, 512 for section 3, etc.) is added to the 
STATAB index in the UCB. This is then multiplied by ten and added to the starting 
address of the statistics table to give the address of the proper entry. When the 
desired entry is in section 1, the STATAB index itself is multiplied by ten and added 
to the address of the statistics table. For the 2314, the low-order four bits of the 
fifth sense byte are also added to the STATAB index to get the correct entry. 



\ UCB 256 f UCB 512 f UCB 768 



Entry for UCB 1 



Entry for UCB 2 



Entry.forUCB3 



Entry for UCBr? 



Control 
Field 



Device Statistics Table Entries 
2314 Devices 



0(0) 1 

Temporary Temporary 
Read Write 
Failures Failures 


KD | 

Bus-Out 
Check 


2(2) | 

Equipment ^^ 
Check 


3(3) | 

Track c , 
Seek 
Condition _. , 
_. . Check 
Check 


4(4) J 
Unsafe 

1 


5(5) J 

. . .. , Control 

Senalizer/ 

^ ... Unit 

Deserializer x . . 

Tag Line 

1 


6(6) 

Arithmetic 
Logical 
Unit 

1 


7(7) ^ 
Missing 
Address 
Marker 

1 


8(8) 

Work Area 


9(9) 

Work Area 







2-16 OS/VS1 Programmer's Reference Digest 



Device Statistics Table (cont'd) 



Unit Record Devices 



0(0) 1 
Temporary iTemporary 
Read Write 
Failures Failures 


KD 1 

Bus-Out 
Check 


2(2) . 1 

Equipment | Overrun 
Check 


3(3) 
Device 
Dependen 
(Sense 
Byte 6) 


1 Device 

Dependent 
1 (Sense 
| Byte 7) 


4(4) 


5(5) 


6(6) 


7(7) 


8(8) 

Work Area 


9(9) 

Work Area 









2400 Series and 3400 Magnetic Tape Devices 



0(0) 1 
Temporary 'Temporary 
Read Write 
Failures Failures 


KD 

Intervention 

Required 


Bus-Out 
Check 


2(2) 

Equipment 

Check 


Overrun 


3(3) 
Word 
Count 
Zero 


1 Data 
Converter 
[Check 


4(4) J 
Read/ Longitudi- 
Write Vert, nal Redun- 
Red. Check dancy 
ICheck 


5(5) 
Skew 


Cyclic 
Redundan- 
cy Check 


6(6) 

Skew Reg. 
Vert. Red. 
Check 


Noise 


7(7) 
Read 
Opposite 
Recovery 


Channel 
1 Data 
Check 


8(8) 

Work Area 


9(9) 

Work Area 











Devices Attached to 2820 Control Units 



0(0) 1 
Temporary 'Temporary 
Read Write 
Failures iFailures 


KD 1 

1 Bus-Out 
Check 

1 


2(2) 1 
Equipment | 
Check 


3(3) 1 
Track | 
Condition 
Check 1 


4(4) 

Track Overrun 


5(5) 


6(6) 
No 

Record i 
Found 


7(7) 


8(8) 

Work Area 


9(9) 

Work Area 







Devices Attached to 2841 Control Units 








0(0) 

Temporcry 
Read 
Failures 


Temporary 

Write 

Failures 


KD 1 

Bus-Out 
Check 


2(2) i 
Equipment Overrun 
Check '■ 


3(3) 
Track 
Condition 
Check 


Seek 
Check 


4(4) 
Unsafe 




5(5) 

Serializer/' Control 
Deserial- . Unit Tag 
izer Line 


6(6) 1 
Arithmetic 
Logical i 
Unit 


7(7) 
Missing 
Address 
Marker 




8(8) 

Work Area 


9(9) 

Work Area 









Section 2: System Information 2-17 



Device Statistics Table (cont'd) 

3410 Series Magnetic Tape Devices 



0(0) 


KD 

Noise 
1,0 


2(2) 

VRC 
3,0 


3(3) 

MTE/LRCR 
3,1 


4(4) 

EDC/CRC 
3,3 


5(5) 

Envelope Check 
3,4 


6(6) 

Overrun 
0,5 


Skew 
3,2 


7(7) 

Spare 
3,7 


Spare 
4,3 


8(8 

PE 

ID 

CH 

5,3 


) 
Mask 
Expan 

1 1 


lit 
ion 

1 1 


P 


9(9) 
Track in 
Bits 2, 

0| 1 | 2 | 3 


Error Mask 
-7 

4|5| 6 |7 


10(A) 
Write TM 
Check 

5,2 


Parity 
Compare 

5,4 


1KB) 
Tach 
Check 

5,5 


False 
End 
Mark 
5,6 


12(C) 
Spare 
8,0 


Feed- 
Through 
Check 
8,1 


13(D) 
Spare 
8,2 


End 

Velocity 

Check 

8,3 


14(E) 

No Read- 
back Data 

8,4 


Start 
Velocity 
Check 
8,5 


15(F) 
Spare 
8,6 


Spare 
8,7 


16(10) 
Not Used 
9,0 


Not Used 
9,1 


17(11) 
Not Used 
9,2 


Not Used 
9,3 


18(12) 

Backward 
3,6 


19(13) 

Bus-Out 
Check 
0,2 


Tape Unit 
Position- 
ing Check 
4,0 



3420 Series Magnetic Tape Devices 



0(0) 


KD 


2(2) 


3(3) 






Noise 


Read Write VRC 


MTE/LRCR 




1,0 


3,0 


3 


1 


4(4) 


5(5) 


6(6) 1 


7(7) 


Write 


EDC/CRC 


Envelope CheckARC 


Overrun Skew 


C- Com pa re 


Trigger 
VRC 


3,3 


3,4 


0,5 


3,2 


3,7 


4,3 


8(8) 


9(9) 


10(A) 


Start 
Read 
Check 


1KB) 


Excessive 


PE 


Mask Bit 




Track in Error Mask 


Write 


Partial 


Post 


ID 
CH 


Expansion 




Bits 2, 0-7 


TM Check 


Record 


Amble or 
TM 


5,3 


1 1 


1 I 


P 


0| 1 ] 2 | 3 


4|5|6|7 


5,2 


5,4 


5,5 


5,6 


12(C) 




13(D) 




14(E) 




15(F) 




IBG Drop 


Feed- 




Early Begin 


Early End 


Slow Begin 


Slow End 


Velocity 


While Through 


Spare Readback 


Readback Readback 


Readback 


Retry 


Writing 


Check 




Check 


Check Check 


Check 




8,0 


8,1 


8,2 


8,3 


8,4 | 8,5 


8,6 


8,7 


16(10) 


Vel. 


17(11) 




18(12) 


19(13) 




Change 








Bus-Out 


ALU 


Not Used During 


Not Used Not Used 


Backward 


Check 


Hardware 


IWrite 








Error 


9,0 | 9,1 


9,2 J 9,3 


3,6 


0,2 


4,0 



2-18 OS/VS 1 Programmer's Reference Digest. 



If request is 


and data set is 


,pccmc 


nonspecific 


temporary 


nontemporary 


X 




X 




X 






X 




X 


X 






X 




X 


l)V6>Ser: 
2)Vol=Ref to 
Another DS " 
in Job Step 
or to the 
Catalog 

Old DS Must 
Always Use 
Specific Req 


No Vol Serial 
is Stated or 
Implied 

Only for New 
DS 


l)No 

DSNAME 
2)&DSNAME 
3)Disp=(New, 

Delete) 
4)Add Card 

That Refers 

Back to Any 

of Thes*e 


1)Old Data Sets 
2)Disp Keep or 
CATLG 



then it can be satisfied with a volume that is: 


Permanently Resident 


Reserved 


Removable 


Public 


Private 


Storage 


Public 


Private 


Storage 


Public 


Private 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 




X 


X 








X 






X 


(See Note) 




These Volumes Are Never 
Available for Dismounting by 
the System. 

1) Nondismountable (2305) 

2) IPL Vol 

3) LINKLIB, PROCLIB, 
JOBQE, page, or SPOOL 
Volumes 

4) Via PRESRES 


Not Available for Dis- 
mounting until an Unload 
CMD Is Issued. 

1) Via PRESRES 

2) Via a MOUNT CMD 


These Volumes Are 
at the Disposition of 
the System. 
1) All Other DA 
Volumes 



Note: This type of request is satisfied by a public removable volume that is made private. 



ALLOCATION CHARACTERISTICS 



A STORAGE volume is: 

Designated in PRESRES. 
A volume for which the mount 
command has been given with 
a USE parameter of STORAGE 
(i.e., MOUNT 131, USE= 
STORAGE) . 



A PRIVATE volume: 

Designated in PRESRES. 
Requested with the PRIVATE 
subparameter specified, and the 
volume is removable. Was re- 
quested nonspecifically for a 
nontemporary data set and the 
request had to be satisfied with 
a removable volume. 
A volume for which the mount 
command has been given with a 
USE parameter of PRIVATE (i.e., 
MOUNT 131, USE=PRIVATE 
(default)). 



A PUBLIC volume is: 

Designated in PRESRES. 
A removable volume that 
has not been made 
PRIVATE. 

A volume for which 
the mount command 
has been issued with 
a USE parameter of 
PUBLIC (i.e., MOUNT 
131, USE=PUBLIC). 



Completion Code Summary 



Group 


Completion 
Code 


Operation of 
Macro Instruction 


Explanation 


BISAM/ 
BSAM/ 
QSAM/ 
BDAM 


001 


CHECK, GET, PUT 


I/O error; terminate specified or no 
SYNAD specified. 


BSAM/ 
QSAM/ 
QISAM/ 
ISAM 


002 




Record is greater than 32,768 bytes, exceeds 
maximum track length or stated block size; 
block could not be contained in one extent; 
too many tracks specified for cylinder over- 
flow; BDW or RDW (SDW) invalid; record to 
be transferred larger than track capacity. 


BSAM/ 
QSAM/ 


003 
004 


EOB for 3525 

OPEN for 3525/ 
3505 


3525 associated data set I/O sequence error. 

Invalid FORMAT card or invalid device 
specified with OMR; conflicting or Invalid 
DCB parameter; data protection image not 
found in SYS1.IMAGELIB. 


BSAM 


005 
008 


READ for 3886 

CHECK while 
creating data set 


Invalid DECB 

SYNAD returned to CHECK routine, but save 
area was destroyed. 


BDAM 


020 
025 
026 


OPEN 

Processing with 
exclusive control 


Invalid DCBMACRF field. 

Address in DCBSQND field outside task. 

Invalid DCBXARG field or exclusive control 
status not indicated. 


BISAM/ 
QISAM 


030 
032 
033 

036 
037 
03A 


OPEN 
OPEN 
OPEN 

OPEN 
OPEN 
CLOSE 


Invalid DCBMACRF field. 

Invalid DCBMACRF field. 

I/O error in reading highest level index or 
while reading the last prime data block or 
in validating last record pointers; address in 
DCBMSHI field outside task or under incorrect 
protection key. 

No prime area specified. 

User supplied buffers too small . 

I/O error writing updated format 2 DSCB. 


BISAM 


034 
035 


OPEN 
OPEN 


DCBSMSI field specifies area too small for 
highest level index; invalid address in 
DCBMSWA. 

DCBSMSW and DCBMSWA fields specify area 
too small for one track. 


QISAM 


031 
038 
039 

03B 
03E 


OPEN 
Scanning 

OPEN 
OPEN 


QISAM I/O error; no SYNAD specified. 

Index area too small or crosses volumes. 

End of data set; no exit routine address in 
DCBEODAD field. 

ISAM data set to be processed, but not crea- 
ted or its DCB not closed after creation; 
invalid DCBRKP field; DCBKEYLE field was 
zero; OPEN macro not issued for output; 
BLKSIZE or LRECL specified incorrectly. 

No space available for resume loading. 



2-20 OS/VS1 Programmer's Reference Digest 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


BDAM/ 
BISAM/ 
QISAM 


03 D 


OPEN 


Missing format 2 DSCB, or serial numbers for 
SER in DD not in order or not all present. 


TCAM 


040 
041 

042 

043 

044 

045 

046 


OPEN 
OPEN 

Processing 

OPEN 

Processing 

Message Control 
Program (MCP) 

CLOSE 


Error in opening a TCAM line group data set. 

Error in opening a TCAM message queues 
data set. 

Error in running a TCAM MCP with the 
telecommunication on- line test executive. 

Error in opening a TCAM application program 
data set. 

Error in processing the FE Common Write 
subtask. 

I/O error or logical read error. 

TCAM MCP is scheduled to be terminated, 
application program data set is active. 
Completion code is for the application 
program data set. 


Graphics 
access 
method 

(GAM) 


056 

057 

061 
062 

063 


Graphics attention 
service routine 

Graphics attention 
service routine 

CLOSE 

Graphics Subroutine 
Package (GSP) for 
FORTRAN IV, 
COBOL, and PL/I 


ANALYZ or GSERV specified DCB, which 
pointed to DEB, which pointed to invalid 
UCB. 

ANALYZ or GSERV specified DCB, which 
pointed to DEB, which pointed to UCB for 
other than graphics device. 

CLOSE issued DAR for GACB that was not ' 
specified (via SPAR) for the closing task. 

Return code equal to or greater than absolute 
value of null argument produced. 

2250 operator pressed alphameric keyboard 
CANCEL key and selected DUMP or 
TERMINATE option to terminate program. 


BTAM 


090 
091 

092 

093 
094 

095 

096 


OPEN 
OPEN 

OPEN 

OPEN 
OPEN 

OPEN 

OPEN 


UCB for other than communications device. 

UCB specified invalid or unsupported 
transmission control unit. 

UCB specified invalid or unsupported terminal 
control or adapter. 

UCB specified invalid or unsupported terminal 

UCB specified invalid or unsupported optional 
feature or mode of operation. 

Line group did not have identical terminal 
types and/or optional features. 

DCBBFTEK field specified dynamic buffer 
allocation, but DCBBUFCB, DCBBUFNO,and 
DCBBUFL fields not specified. 



Sec,tion2: System Information 2-21 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


BTAM 
(cont'd) 


097 
098 


OPEN 
OPEN 


Device I/O directory full. 

Transmission control unit not a 2701 or the 
Dual Communication Interface, or Dual Code 
Feature not specified in UCB. 


Job 
sched- 


0B0 




I/O error in reading or writing 
SYS1.SYSJOBQE or SWADS. 




0B6 




System logic error while accessing resident 
job listorSYSl.SYSJOBQE. 




1B0 




Invalid TTR for SYS1 .SYSJOBQE found by 
system conversion routine. 


Prologue 


OCx 




Program interruption, not in I/O interruption 
handler or type 1 SVC routine; no program 
routine to handle interruption; x=program 
interruption code. 




0D3 




Program interrupt caused by invalid set 
system mask instruction. 




OF! 




Program interrupt in I/O interrupt handler. 




0F2 




Program interrupt in type 1 SVC routine. 




0F3 




Machine-check interrupt; MCH able to 
abnormally terminate job step and continue 
operating system. 




0F5 




Program interrupt occurred while loading 
transient area for type 3 or 4 SVC. 


EXCP 
(SVC 00) 


100 
200 


I/O Operation 
I/O Operation 


Device not operational . 

Invalid ECB, IOB, DCB protect key. 




300 


I/O Operation 


Invalid DEB protect key; not enough extents 
in DEB. 




400 


I/O Operation 


Invalid DCB pointers. 




500 


I/O Operation 


Invalid UCB address. 




600 


I/O Operation 


Requested by subsystem (EXCPVR) and JSCB 
is missing or subsystem bit in JSCB is not on. 




700 


I/O Operation 


No SQA (system queue area) available for 
the request or the system lock was set. 




800 


I/O Operation 


Invalid address of a control block appendage, 
CCW, or CCW data field was found . 




900 


I/O Operation 


The translated channel program contains 290 
CCWs or more. 




A00 


Modified CCWs 


CCWs modified in a PCI appendage were 
changed to cause the CCW translator to 
need to fix a page . I/O supervisor en- 
countered a page fix request in PCI . 



2-22 OS/VS1 Programmer's Reference Digest 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


EXCP 
(SVC 00) 
(cont'd) 


BOO 
COO 


I/O Operation 
I/O Operation 


Overfix threshold was exceeded. 

Invalid number of entries in the fix list was 
found upon return to IOS from the user fix 
appendage. 


WAIT 
(SVC 01) 


101 
201 
301 


WAIT 
WAIT 
WAIT 


More events than ECBs. 
Invalid ECB address. 
ECB wait flag already on. 


POST 
(SVC 02) 


102 
202 


POST 
POST 


Invalid ECB address. 
Invalid RB address in ECB. 


Task 
termin- 
ation 

(SVC 03) 


103 
A03 
C03 
D03 


RETURN or branch 
to return address in 
register 14 

RETURN or branch 
to return address in 
register 14 

RETURN or branch 
to return address in 
register 14. 

RETURN or branch 
to return address in 
register 14. 


ECB already posted or RB address in ECB 
invalid. 

Subtasks not yet terminated. 

TCBDEB points to DEB that is associated with 
an invalid DCB. WARNING: All data sets 
not closed. 

ENQ resources not released yet. 



Section 2: System Information 2-23 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


GETMAIN 
(SVC 04) 


604 


GETMAIN 


Address in A or LA operand is outside task; 
address of parameter list invalid. 




704 


GETMAIN 


List request; not VS2 system. 




804 


GETMAIN 


Request for zero bytes of virtual storage or 
not enough virtual storage available. 




A04 


GETMAIN 


Storage management queues have been 
altered incorrectly 




B04 


GETMAIN 


Subpool number greater than 127. 




E04 


GETMAIN from 
program in super- 
visor mode 


Not enough SQA available. 


FREEMAIN 
(SVC 05) 


605 


FREEMAIN 


Address in A or LA operand is outside task; 
address of parameter list invalid. 




705 


FREEMAIN 


List request; not VS2 system. 




905 


FREEMAIN 


Address of area to be freed not multiple of 8. 




A05 


FREEMAIN 


Area to be freed overlaps existing free area. 




B05 


FREEMAIN 


Subpool number greater than 127. 


Contents 
supervi- 
se 06) 


106 
406 


LINK, LOAD, 
ATTACH, XCTL 

LINK, ATTACH, 
XCTL 


Error while loading module into virtual 
storage; invalid record type, invalid address, 
I/O error. 

Module was only loadable; module specified 
by entry point defined by IDENTIFY macro. 




506 


LINK, LOAD, 
ATTACH, XCTL 


Not enough virtual storage for module and 
overlay supervisor. 




606 


LINK, LOAD, 
ATTACH, XCTL 


Not enough virtual storage for module. 




706 


LINK, LOAD, 
ATTACH, XCTL 


Module marked "NOT EXECUTABLE." 




806 


LINK, LOAD, 
ATTACH, XCTL 


BLDL detected error; module not found or I/O 
error during directory search. 




906 


LINK 


More than 255 tasks waiting for reenterable 
or serially reusable module. 




A06 


LINK, LOAD, 
ATTACH, XCTL 


Task already waiting for serially reusable 
module. 




B06 


I/O activity 


Abnormally terminating system error task 
reinstated; user task abnormally terminated. 




C06 




Abnormally terminating transient area task 
reinstated; user task abnormally terminated. 


XCTL 
(SVC 07) 


207 


XCTL 


Asynchronous exit routine attempted to 
execute XCTL. 


LOAD 
(SVC 08) 


308 


LOAD 


Module specified by entry point defined by 
IDENTIFY macro. 



2-24 OS/VS1 Programmer's Reference Digest 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


GETMAIN, 
FREEMAIN 
with R 
operand 
(SVC OA) 


60A 
80A 


FREEMAIN 
GETMAIN 


Invalid specification of an area to be freed; 
address of area to be freed (in register 1) not 
multiple of 8. 

Request for zero bytes of virtual storage or 
not enough virtual storage available. 




90A 


FREEMAIN 


Address of area to be freed not a multiple 
of 8. 




AOA 


FREEMAIN 


Area to be freed overlaps an existing free 




BOA 


GETMAIN, 
FREEMAIN 


Subpool number greater than 127. 


ABEND 
(SVCOD) 


DOD 


ABEND 


Invalid ABEND recursion during abnormal 
termination of subtask; job step task 
terminated. 




EOD 


ABEND 


Insufficient virtual storage available for 
ABEND processing of subtask, job step 
terminated. 


OPEN 
(SVC 13) 


013 


OPEN 


Conflicting or unsupported parameters in 
DCB; member name specified in DD not 
not found; no directory allocation subparam- 
eter in DD. 




113 


OPEN, OPEN 
with TYPE = J 


I/O error in reading or writing JFCB or in 
reading JFCB extension block; no exit code 
provided. 




213 


OPEN 


DSCB not found; I/O error in reading or 
writing DSCB; unable to locate PASSWORD 
data set. 




313 


OPEN 


I/O error in reading format 2 or 3 DSCB. 




413 


OPEN 


INPUT specified but no serial number for SER 
in DD; I/O error in tape positioning or label 
processing; could not mount volume on 
device; more devices allocated than volumes. 




513 


OPEN 


Attempting to open second DCB for same tape 
volume. 




613 


OPEN 


I/O error in label processing or tape posi- 
tioning. 




713 


OPEN 


Expiration date not reached, but data set 
opened for output and DD contained MOD in 
DISP. 




813 


OPEN 


Verification error in label processing. 




913 


Supplying 
password 


Incorrect password entered; ASCII tape 
accessibility error, ASCII tape security error. 




A13 


OPEN 


File sequence number in LABEL in DD 
incorrect. 



Section 2: System Information 2-25 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


OPEN 
(SVC 13) 

(cont'd) 


B13 
C13 

D13 
E13 


OPEN for UCS 
printer 

OPEN 

OPEN for graphics 
OPEN for graphics 


Operator cancelled UCS load; incorrect UCS 
image; space unavailable for DCB and DEB; 
SYS1.IMAGELIB not mounted or cataloged; 
permanent I/O error detected. 
I/O error in reading JFCB or DSCB for con- 
catenated data set; DSCB not found for one 
data set in concatenation; graphic device 
already opened by another task; output data 
sets concatenated. 

DCB for other than graphics device. 

DCBGNCP field not 1 through 99. 


CLOSE 

(SVC 14) 


214 

314 
414 
514 
614 
714 
A14 

B14 
D14 


CLOSE 

CLOSE 
CLOSE 
CLOSE 
CLOSE 
CLOSE 
CLOSE 

CLOSE 

CLOSE for 
graphics 


I/O error in tape positioning or volume 
disposition. 

I/O error reading DSCB. 

I/O error writing DSCB. 

I/O error reading JFCB. 

I/O error writing file mark. 

I/O error processing label, or tape mark. 

I/O error releasing unused direct access 
space. 

STOW unable to store, modify, or delete 
data from partitioned data set directory 
because name already in directory, no space 
available in directory, or I/O error search- 
ing directory. 

Graphic device not opened by closing task. 


TCLOSE 
(SVC 17) 


117 
217 
317 
417 
717 


BSAM CLOSE 
wmiTV*fc = T 

BSAM CLOSE 
with TYPE = T 

BSAM CLOSE 
with TYPE = T 

BSAM CLOSE 
withTYPE = T 

BSAM CLOSE 
with TYPE = T 


I/O error in tape positioning or writing file 
mark. 

I/O error reading JFCB. 

I/O error reading DSCB. 

I/O error writing updated DSCB. 

I/O error processing label or tape mark. 


Master 
sched- 
uler 

(SVC 22) 


122 
222 

322 




Operator cancelled job; requested dump. 

Operator cancelled job; did not request 
dump. 

Execution of job step or cataloged procedure 
taking longer than time specified. 



2-26 0S/VS1 Programmer's Reference Digest 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


Master 
sched- 
uler 
(SVC 22) 
(cont'd) 


422 
522 




Job required too much queue space for 
initiation. 

All tasks in SVC wait state for 30 consec- 
utive minutes or for time specified in JWT 
parameter (in systems with SMF). 


WTO/ 

WTOR 
(SVC 23) 


D23 
E23 


WTO, WTOR 

Reply command 
processing (in 
response to WTOR) 


Parameter list not begin on proper boundary; 
no buffers available; text length equal to or 
less than zero (WTOR only). 

Invalid ECB, RB, or reply address. 


EXTRACT 
(SVC 28) 


128 
228 

328 


EXTRACT 
EXTRACT 

EXTRACT 


Output list not on fullword boundry or not 
contained in storage assigned to job step. 

Input parameter list not on fullword boundary 
or does not begin in storage assigned to job 
step. 

TCB not for immediate subtask. 


ATTACH 
(SVC 2A) 


42A 
62A 


ATTACH 
ATTACH 


Address for ECB to be posted upon subtask 
termination is not multiple of 4, or not within 
bounds of partition. 

Exceeded allowed number of tasks. 


CHAP 
(SVC2C) 


12C 
22C 


CHAP 
CHAP 


Address for subtask TCB does not point to TCB 
of immediate subtask, or points to a task that 
has terminated. 

Address for subtask TCB not multiple of 4. 


Overlay 
super- 
visor 

(SVC 2D) 


12D 
22D 

32D 

C2D 

D2D 

E2D 




Words 3 and 4 of segment table invalid. 

Address in segment table or entry table 
outside storage for job step. 

Wrong length record or I/O error when load- 
ing segment. 

Invalid scatter record found while loading 
program segment. 

Invalid record type found while loading 
program segment. 

Invalid address found while loading program 
segment. 


DEQ 
(SVC 30) 


130 

230 
330 

430 
530 


DEQ without 
RET = HAVE 

DEQ 

DEQ 

DEQ 
DEQ 


DEQ for resource not enqueued by prior ENQ, 

Invalid length specified for name of resource. 

Invalid option specified by task with non- 
zero protection key. 

Invalid parameter list. 

Task does not yet control specified resource. 



Section 2: System Information 2-27 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


EOV 
(SVC 37) 


137 


End of volume 


I/O error in label or tape mark processing or 
tape mark positioning. 




237 


End of volume 


Verification error in label processing; tape 
label block count not same as DCB block 
count. 




337 


End of data set 


No address specified in DCBEODAD field. 




437 


End of volume 


Protect key different in TCBPKF field of TCB 
and DEBDEBID field of DEB. 




537 


End of volume 
for multiple 
volumes 


Specified volume being used for another 
data set. 




637 


End of volume 


I/O error in writing tape mark, positioning 
tape, reading label, sensing for file protect 
ring; DCB bit does not indicate concatena- 
tion of unlike attributes. 




737 


End of volume or 
allocation of 
secondary quantity 


Direct access I/O error; DSCB not found for 
multi-volume or concatenated data set. 




837 


End of volume for 
sequential data set 


I/O error reading or writing JFCB from or 
onto direct access; JFCB extension needed 
but not found. 




A37 


End of Volume 


DCB not open; DCB not pointing to a proper 
DEB. 




B37 


End of volume 


Volumes must be demounted from a device 
allocated to the data set, but system unable 
to demount volume. 




D37 


Output operation 


More space needed but no secondary quantity 
specified for SPACE in DD. 




E37 


Output operation 


More space needed but not enough volumes 
specified in SER, volume count, or REF in DD. 


ENQ 
(SVC 38) 


138 


ENQ without 
RET=TEST, USE, 
or HAVE 


Second ENQ without intervening DEQ. 




238 


ENQ 


Invalid length for resource name. 




338 


ENQ 


Invalid option specified by task with non- 
zero protection key. 




438 


ENQ 


Invalid pGrGmeter list. 


DETACH 
(SVC 3E) 


13E 
23E 


DETACH 
DETACH 


Subtask being detached not yet terminated. 

TCB address not on word boundary; subtask 
TCB not on word boundary; subtask TCB=0 or 
not an immediate subtask. 


CHKPT 


13F 




Error during execution of checkpoint restart. 



2-28 OS/VS1 Programmer's Reference Digest 



Completion Code Summary (cont'd) 



Group 


Completion 
Code 


Operation or 
Macro Instruction 


Explanation 


RDJFCB 


140 
240 


RDJFCB 
RDJFCB 


I/O error in reading JFCB. 

No foundation extension block in DCB; 
EXLST address in DCB; JFCB exit in DCB exit 
list; JFCB buffer not in user's virtual storage. 


SWAP 
(SVC 55) 


155 




SVC 85 (in decimal) issued by user's task, but 
is restricted for use by Dynamic Device 
Reconfiguration. 


System 

Restart 


2F3 




Job was being executed when system failure 

occurred; a system restart was performed. 


Supervi- 
sor Call 
(SVC nn) 


Fnn 




Invalid or restricted operand, nn, in SVC 
instruction . 


ESR 
(SVCs 
109, 116, 
117) 


16D 




Invalid ESR code in register 15. 


Paging 


028 




Page file I/O error. 


Misc. 


2FF 

722 

822 
16E 

1B0 

3FE 
4FE 

DOO 


ABEND 
appendage 

DEBCHK 


Step terminated at request of user appendage 
III. 

OUTLIM keyword specified on SYSOUT DD 
statement exceeded. 

V=R region not obtained. 

Control program requested a DEBCHK func- 
tion be performed on a data extent block 
(DEB) obtained from the DCB passed by the 
program. Function could not be completed. 

System conversion routine encountered an 
invalid TTR for an address in the SYS1. 
SYSWADS data set. 

Task attempted to end normally but telepro- 
cessing I/O requests were active or pending 

Task attempted to end normally but non- 
teleprocessing I/O requests were pending 
and no teleprocessing I/O requests were 
outstanding. 

Error occurred during processing of a SIO 
extended request. 



Section!: System Information 2-29 



Wait State Codes 

001 IPL/NIP: Not operational in response to a test I/O instruction (reg. 1Q=unit 
address) . 

002 IPL/NIP: I/O operation not initiated, CSW stored, and channel not busy 
(reg. 10=unit address) » 

003 IPL/NIP: I/O operation not initiated, CSW not stored, and channel not busy; 
or SYS1.LINKL1B not cataloged, no UCB found for IPL device, unexpected 
"not operational" condition found (reg. 10=unit address). 

004 IPL/NIP: I/O operation not initiated, CSW not stored, channel not busy 
(reg. 10=unit address) . 

005 IPL/NIP: I/O Interrupt because of unit check (if IPL, fourth byte of PSW= 
X'00'; X'4C*=address of CCW causing check; X'54'=sense bytes describing check. 
Reg. 10=unit address). 

006 IPL/NIP: interface control check, channel control check, channel data check, 
program check, or channel chaining check occurred. 

007 NIP: Console not available. 

008 NIP: I/O interruption because of unit check. Record not found, unformatted 
direct access volume mounted on online device, or volume label on an alternate 
track (reg. 10=unit address). 

009 NIP: I/O interruption because of unit check. File mask violation (reg 10= 
unit address). 

00A SYS1.LINKLIB not found in catalog 

OOF IPL: Volume not containing IPL text used for IPL. 

010 NIP: I/O interruption because of unit check. End of cylinder (reg 10=unit 
address) . 

011 NIP: I/O interruption because of unit check. Track condition check occur- 
red (reg. 10=unit address). 

013 NIP: Recovery not possible. Check system completion code. 

017 IPL/NIP: Unit check while executing sense instruction (reg. 10=unit address). 

018 IPL: Nucleus too big for machine size. Space for RLD records exceeded. 

019 IPL: Program interruption because of hardware errors or SYS1 .NUCLEUS 
occupying more than one extent. 

021 NIP: I/O interruption on teleprocessing or graphic console (reg. l=po inter to 

IOB for failing EXCP operation). 
0E2 NIP: Machine check interruption occurred before machine check handler 

initialized. 
0F1 DSS: Error processing encountered error preventing reinstatement of VS 

processing (Message IQA016W). 
0FA DSS: Translation specification exception (Message IQA010W). 

900 NIP: Error occurred during initialization of one or more page data sets 
(Messages IE A750W, IEA751W, IEA752W, IEA753W, IEA754W, IEA755W). 

901 SUPVR: Channel program check during paging I/O operation. 

902 SUPVR: Uncorrectable I/O error while pageable supervisor was being read 
into real storage from SYS1 .PAGE data set. 

903 SUPVR: Page supervisor ended abnormally. 

904 NIP: Unable to complete system initialization. 

905 IPL: CPU model number obtained by a Store CPUID instruction not found in 
IPL list of supported models. 

906 IPL: Machine check interruption because of either a malfunction other than 
a storage error or uncontrollable real storage error in first 256K of storage. 

907 NIP: Link or load failed for an essential module (Message IEA782W). 

908 NIP: System generated with extended timer support but clock comparator 
and CPU timer not supported by hardware. 

A01 RMS: Error occurred while performing recovery. Probable machine check 

on machine check. (Message IGF910W). 
A02 RMS: Error occurred while performing a recovery. Probable machine check 

on machine check. 
A03 RMS: Error occurred while performing a recovery. Probable program check 

on machine check (Message IGF910W). 
A04. MCH: I/O error during machine check recovery (Message IFG930W). 
A05 MCH: Unrecoverable failure within supervisor area (Message IGF900W). 

A0A MCH: Encountered failure that channel check handler could not correct. 

A0C MCH: Unable to load a page on a low end system (Message IGF930W). 

All RMS: Error occurred while performing a recovery. Probable invalid 

machine check interrupt code (Message IGF910W). 
A16 MCH: Failure in time of day clock, clock comparator, or CPU timer 

(Message IGF950W). 
A17 MCH: Failure in interval timer (Message 1GF950W). 



2-30 OS/VS1 Programmer's Reference Digest 



Wait State Codes (cont'd) 



B01 


3211 Utility 


Completed normally. 


B02 


3211 Utility 


Control card missing or out of order. 


B03 


3211 Utility 


JOB statement is incorrect. 


B04 


3211 Utility 


DFN statement is incorrect. 


B05 


3211 Utility 


UCS statement is incorrect. 


B06 


3211 Utility 


FCB statement is incorrect* 


B07 


32H Utility 


END statement is incorrect. 


BOA 


3211 Utility 


External interrupt has occurred. Interrupt key was pressed. 


BOB 


3211 Utility 


Program check interrupt has occurred. 


BOC 


3211 Utility 


Machine check interrupt has occurred. 


Bll 


3211 Utility 


Reader is not online. 


B12 


3211 Utility 


Reader is not ready. 


B13 


3211 Utility 


Reader is not ready. 


B14 


3211 Utility 


Reader channel error has occurred. 


B15 


3211 Utility 


No device end is indicated on the reader. 


B19 


3211 Utility 


Printer is not online. 


BIB 


3211 Utility 


Unit check has occurred on the printer. 


B1C 


3211 Utility 


Printer channel error has occurred. 


BID 


3211 Utility 


No device end is indicated on the printer. 


DOI 


SUPVR: ABTERM or PROLOG failed while processing the terminating program 


E02 


CONSOLE: 
was availabl 
SUPVR: SQ 


Permanent I/O error on 2250 display unit. No alternate console 


E04 


A had less than 288 bytes. GETMAIN request was issued for more 




SQA space 


har> was available. 



Section 2: System Information 2-31 



System ENQ/DEQ Names 



Major Minor 

SYSDSN dsname 

SY5IEECT IEEWQE 

SYSIEECT IEERQE 

SYSIEFSD Ql 

SYSIEFSD Q2 

SYSIEFSD Q3 

SYSIEFSD Q4 

SYSIEFSD Q5 



SYSIEA01 IEA 

SYSVTOC vol-ser 

SYSPSVVRD PASSWORD 

SYSDSNbb SYSCTLG 

SYSIGGLG M3BCCHHR 



Used by the initiator to ENQ on each temporary dsname 
specified in the DD statements of a job. 

Used by WTO routines when all console buffers are full. 

Used by WTOR routines when the number of outstanding 
reply requests is at the system limit. 

Used by queue manager during processing of ENQ/DEQ 
to prevent queue control records (QCRs) overlay/lock-out. 

Used by queue manager during processing of assign and 
delete to prevent master QCR overlay/lock-out. 

Used by queue manager during processing of "no :pace 
in job queue' condition. 

Used by I/O device allocation to interlock' UCBs 
against multiple references by other allocation routines. 

Used by I/O device allocation to prevent interaction o r 
updates to UCBs. Provides allocation a means of releas- 
ing UCBs to termination. 

Used by initiator to permit cancellation of a system 
program during device allocation. 

Used by output writer when deleting current output Q 

Used by ABEND and SNAP to obtain access to the dump 
data set. 

Used by DADSM to provide VTOC integrity. 

rial update to the security 



Used by OPEN/EOV to 
data set. 



Used by CATALOG for system catalog integrity. 



Used by BDAM during exclusive read/write to obtain 
exclusive control of RO (capacity record). 



SYSIEFSD 


WD 




Used 


by 


the accounting data set wr 


iter (module IEFWAD). 


SYSIEWL 


(dsnar, 


efor 


Used 


by 


linkage 


editor. 






SYSLMOD) 












SYSCTLG 


SYSC 


'LG 


Used 


by 


catalog 


management to en 


ure catalog integr ; *y. 


SYSIEC16 


X'FO' 




Used 


by SVC 16 (PURGE) to get ex 


elusive use of caller's 








DEB cha 


n. 






SYSSMF01 


BUF 




Used 


by 


SMF SVC 83 to ensure the 


exclusive use cf the 








SMF buffer. 






Modules Using ENQ/DEQ 












Module Name 




ENQ Minor 






Module Nam 


; ENQ Minor 


IEESD561 




Ql 








IEFXV001 


Q5 


IEESD565 




Ql 








IEFWA000 


Q5 


IEESD575 




Ql 








IEFWEXTA 


Q5 


IEESMFWT 




Ql 








IEFWD0OO 


Q5 


IEFSD160 




Q2 








IEFSD195 


Q5 


IEFSD161 




Q2 








IEFSD41Q 


Q5 


IEFWEXTA 




Q4 








IEFVMSL1 


Q5 


IEFSD41Q 




Q4 








IEFACTLK 


Q5 


IEFSD21Q 




Q4 








IEFSD162 


a 7 


IEEVMNT2 




Q5 








IEFOSC05 


CPOWAir 


IEFZGJB1 




Q5 








IEFVMB 


dsnnrr.e 


IEFZGST1 




Q5 








IEESMF8C 


BUP 


IEFZGST2 




Q5 








IEAQTM02 


IEA 



2-32 OS/VS1 Programmer's Reference Digest 



How To Find Associated Logical Channel Word 

CVT PTR (m4U) to LCW Table 



/ UCB HO \ 



•■ LCW 



[ LCH 1AB/ 

LOGICAL CHANNEL WORD TABLE 

The logical channel word table consists of the logical channel words that control the 
logical channel queues. It is used by the I/O supervisor and the I/O purge and SVC 

purge routines. 

The logical channel word table has the following characteristics: 
I . Creation: The table is created at system generation time. 

2. Storage Area: The table resides, as a permanent part of the fixed nucleus. 

3. Size: Tht table contains one 8-byte logical channel word per logical channel 
queue. 

4. Means of Acce ss: Find the start of the LCW table in CVT + 8C; add to this 
pointer the value of the LCHTAB byte in the UCB (UCB + A) multiplied by eight. 

The fonnat of a logical channel word is: 



FIRST 
REQUEST 



h-2 bytes 



LAST 
iiEOUEST 



- 2 bytes - 



SCRATCH 



-2 bytes - 



TCH MOD 

ADDR 



-2 bytes— *- 



-8 bytes - 



FIRST REQUEST (2 bytes) 

These two bytes contain either an address or an index value to the first request 
element in the logical channel queue. 

LAST REQUEST (2 bytes) 

These two bytes contain either an address or an index value to the last request 
element in the logical channel queue. 

SCRATCH (2 bytes) 

This field is used as a temporary storage area for an address or index value. The 
field is used when more than one logical channel queue for a physical channel is 
starched in order to find the highest priority I/O request with which to restart the 
channel . 

Kh MOD ADDR (2 bytes) 

This field addresses the device-dependent test channel module. 



1 . When o looical channel queue is void, the FIRST REQUEST field contains 
a dummy link address of hex FFFF and the LAST REQUEST field contains the 
address of lhat logical channel word. 

'/.. When there is only one request element in the queue, both FIRST REQUEST 
and LAST REQUEST contain the address of that element. 



Section 2: System Information 2-33 



How To Find the Entry Point of Types I and II SVCs 

A. Pick up the instruction address from the SVC New PSW at X'60' . 

B. Starting at the location in Step A, search for the first LM instruction (98 89 OXXX). 

C. The pointer to the SVC table is at address XXX (step B), 

D. The pointer to the SVC prefix table is at address XXX+4 (step B) . The pointer to 
the SVC FL1H is at address XXX+8 (step B). 

E . Add the SVC number (hex) to the address of the SVC prefix table . 

F. Pick up the byte value pointed to by the result of step E. 

G. Multiply the value picked up in step F by 4. 

H. Add the results of step G to the address of the SVC table determined in Step C. 

1. The value computed in step H points to a 4-byte address constant which is the SVC 
routine entry point. 

Note that all entry points are on a doubleword boundary. .The three low-order bits in 
the entry address are not part of the actual address. Bits 5 and 6 equal the number of 
doublewords in register save area in SVRB. Bit 7 indicates an SVRB is needed. 

SVC TABLE FORMAT 



2 


6 


21 


3 


1 

c 
k 





Virtual storage address 
of SVC routine 






4-byte entry for type 1 SVC routines 



2 


2 


1 


3 






e 




1 




n 




o 
c 





a 
b 


ESA* 


k 




1 

e 





* ESA Is the number of doublewords required for The 
extended save area in the request block. 



1-byte entry for type 3 
and 4 SVC routines 



2 


5 


1 


21 


3 






e 






1 




n 






o 





a 


Virtual storage address 


ESA* 


c 


b 


of SVC routine 




k 




1 

e 







4-byte entry for type 2 SVC routines 



2-34 OS/VS1 Programmer's Reference Digest 



how To Find (cont'd) 

SVC Table Pernor (cont'd) 



10 


8 


12 


2 


12 


1 


3 


frock 


Record 


Length of first 


1 
o 


Attributes of SVC 


e 
n 


ESA* 


Address 


number 


text record 


c 


routine 


a 




1 , 




k 




b 

1 





6-b/te entry for transient type 3 and 4 SVC routines 
BITS 



8 


22 


2 


12 


1 


3 










e 








1 




n 




X'FF' 


Address of SVC routine 


c 





a 
b 
1 

e 


ESA* 



6-byte entry for fixed type 3 and 4 SVC routines 



* ESA is the number of doublewords required for the 
extended save area in the request block . 



How to Find Resident Build List 

A. Pick up CVT pointer in location X' 10' . 

B. Add X'lC to this pointer. This is CVTPCNVT pointer . 

C. Locate CVTPCNVT entry-8. 

D. This is pointer to resident build list. 

E . Format of resident build list is : 

U- 1 number of entries 
2-2 length of each entry 

44--? en-., number 2, ore. 

Normal length ol eacn entry is AC bytes. 

Ho* i^ Fjnd Resi dent SVC Luod List and RAM List 

The redden, jjVC load list jnd RAM list pointers are two fullwords located before the constant 
IGGU19 IFGM9. The pointers are known as IEAARSV1 and IEAARAM4, respectively, and may 
be located from these names in LMODMAP. These constants are defined in IGC007, IGC008, 
or LINK, XCTL, an<i LOAD code if a system generation listing is availcble. 



Section 2: System Information 2-35 



2-36 0S/VS1 Programmer's Reference Digest 



Section 3: Supervisor Information 



Supervisor Macro Outlines 3-2 

Supervisor Macro Parameter Notation 3-10 

Summary of Supervisor Operands 3-11 

Programming Conventions for SVC Routines 3-17 

SVC Register Contents 3-18 

SVC Directory 3-23 

Load Module Control 3-27 

Synchronization 3-28 

Program Interrupt Control 3-30 

General Services 3-3 1 

Termination 3-32 

Task Control 3-33 

Virtual Storage Allocation 3-34 

Control Flow Diagrams 3-35 



Source Publications 



Additional information about the supervisor macro outlines and SVCs 
is in OS/VS1 Supervisor Services and Macro Instructions, GC24-5103, 
and OS/VS1 Planning and Use Guide, GC24-5090. 



Supervisor Macro General Outline 



Symbol 


Macro 
Name 


Parameters 



Section 3: Supervisor Information 3-1 



Supervisor Macro Outlines 



ABEND 



completion code[,DUMP][,STEP] 



ATTACH 



EP=symbol ] 

EPLOC=address of name [, DCB=dcb address] 

DE=address of list entry J 



PARAM=(addresses)[,VL=l]][,ECB=ecb address] 
ETXR=exit routine address] [,LPMOD=number] 



I 
[, 
[,DPMOD=number 



TQE={^g}][,FPREGSA 



= {*S}] 



ATTACH 
(list form) 



EP=symbol 1 

EPLOC=address of name | [, DCB=dcb address] 

DE=address of list entry j 

[,ECB=ecb address] [,ETXR=exit routine address] 

[,LPMOD=number] [, DPMOD=number],SF=L 

[JQE={£§}][,FPREGSA={£§}] 



ATTACH 
(execute 
form) 



IEP=symbol 
EPLOC=address of name f [, DCB=dcb address] 
DE=address of list entry J 

[,PARAM=(addresses) [,VL=1]] [,ECB=ecb address] 

[,ETXR=exit routine address] [,LPMOD=number] 

[,DPMOD=number] 

MF=(E, [problem program list address 1 



0) 



} 



,SF=(E, (control program list address"! ) 
I 05) I 

,MF=(E, [address l),SF=E, [address! ) 
1 0) I I 05) t 



3-2 OS/VS1 Programmer's Reference Digest 



Supervisor Macro Outlines (cont'd) 



CALL 



f entry point name 1 [, (address parameters)!, VL]] 
I 05) I 

[,ID=number] 



CALL 
(list form) 



, (address parameters) [,VL],MF=L 



CALL 

(execute 

form) 



' entry point name 1 [, (address parameters)] 
05) 1 

[,VL][,ID=number] 

,MF=(E, {problem program list address 1 ) 
I 0) J 



CHAP 



priority change value 



,tcb location address 



f EP=symbol 

I EPLOC=address of name 

I DE=address of list entry 



(qname address,rname address, [rname length] 

STEP ,...)[, RET=HAVE] 

SYSTEM 



DEQ 
(list form) 



([qname address], [rname address], [rname length] 

SYSTEMl , . . .)[,RET=HAVE],MF=L 
STEP 



DEQ 

(execute 

form) 



[([qname address], [rname address] , [rname length] 



SYSTEM 
STEP 



RET=HAVE 
RET=NONE 



,MF=(E, [control program list address 1 ) 
I (1) I 



DETACH 



tcb location address 



fMSG=register ] 
lMSGLIST=addressJ 



regl,reg2 



(qname address, rname address, I" E 1 , [rname length] 



SYSTEM 
STEP 



,...) 



,RET=TEST 
,RET=USE 
,RET=HAVE 
,RET=CHNG 



Section 3: Supervisor Information 3-3 



Supervisor Macro Outlines (cont'd) 



ENQ 
(list form) 



([qname address], [rname address], 



[|] 



, [rname length] , SYSTEM ,.*"..) 

[step J 



,RET=HAVE 
,RET=TEST 
,RET=USE 
,RET=CHNG 



,MF=L 



ENQ 

(execute 

form) 



[([qname address], [rname address] 
,[rnome length], [sYSTEm] , . . .)] 

[step J 



[!] 



RET = HAVE 
, RET = TEST 
,RET = USE 
,RET = NONE 
,RET = CHNG 



,MF=(E, [control program list address] ) 

I 0) ' 



answer area address ,tcb location address 
,'S' 



,FI ELDS = (codes) 



EXTRACT 
(list form) 



[answer area address ] ,tcb location address 
[, Fl ELDS = (codes)], MF=L 



EXTRACT 
(execute 
form) 



[answer area address ] ,Tcb location address 

[/!• J 

[ f FI ELDS = (codes)] 

,MF=(E, {control program list address 1) 

l 0) ' 



E,LV= number, A=address [,SP= number] 
I R,SP = (0) 

R,LV=(0),A=address 

R,LV=(0),A=(1) 
| R, LV=number, A=address [,SP ^number] 

R,LV=number,A=(l)[,SP=number] 
[v,A=address[,SP=number] 



FREEMAIN 
(list form) 



f [E][,LV=number][,A=address][,SP=number] 1 
I [V][,A=address][,SP=number] 



,MF=L 



FREEMAIN 

(execute 

form) 



f[E][,LV=number][,A=address][,SP=number]l 
l[V][ / A=address][,SP=number] I 

,MF=(E, r control program list address l ) 
I (1) I 



3-4 OS/VS1 Programmer's Reference Digest 



Supervisor Macro Outlines (cont'd) 



GETMAIN 


< 


r *EC,LV = number / A = address[ / SP = number]r,BNDRY=|DBLWDlT 
EU.LV = number,A = addressf,SP = number]r,BNDRY=|DBLWD\1 

R,LV=number[,SP=number] 

R,LV=(0) 

VC,LA=address,A=address[,SP=number] |",BNDRY= fDBLWD]1 

VU,LA=address,A=address[,SP=number] |~,BNDRY= fDBLWD}] 
L IPAGE )] J 


> 


GETMAIN 
(list form) 


! 


"[EC][,LV=numbern 

[EU][,LV=number] I 

[VC] [, L A=address] > 1/ A=address] [, S ^number] 
jyU]J / LA=address]J 

,BNDRY= fDBLWD) ,MF=L 
1 PAGE J J 


GETMAIN 

(execute 

form) 


( 


'[EC][,LV=number]") 
[EU][,LV=number] I 
[VC][,LA=address] / 
[VU][,LA=address]J 

,BNDRY= [ DBLWdJ 
j PAGE J 


[,A=address][,SP= number] 
,MF=(E, (control program list address 1 ) 

■ i a) I 


GTRACE 


DATA=address,LNG=number,ID=number[,FID=number] 


GTRACE 
(list form) 


[DATA=address][,LNG=length][,FID=number],MF=L 


GTRACE 
(execute 
form) 


ID=value / MF=(E, f parameter list addressl ) 
1 (1-12) J 

[,DATA=address][,LNG=length][,FID=number] 


IDENTIFY 


f EP=symbol ] , ENTRY=entry point address 
I EPLOC=address of name J 


LINK 


[ EP=symbol 1 [,DCB=dcb address] 
1 EPLOC=address of name | 
I DE=address of list entry J 

[,PARAM=(addresses)][,VL=l][,ID=number] 


LINK 
(list form) 


[EP=symbol 1 [, DCB=dcb address], SF=L 
] EPLOC=address of name \ 
lDE=address of list entry j 



Section 3: Supervisor Information 3-5 



Supervisor Macro Outlines (cont'd) 



LINK 

(execute 

form) 



[" EP=symbol 

I EPLOC=address of name 



[, DC&=dcb address] 
L DE=address of list entry . 
[,PARAM=(addresses)][,VL=l][ / ir>number] 



,MF=(E, fproblem program list address 1 ) 

t 0) i 

,SF=(E, ( control program list address 1 ) 

1 (15) J 

,MF=(E, /address 1 ),SF=(E, f address 1 ) 
I 0) J I 05) I 



[ EP=symbol l [, DCB=dcb address] 

EPLOC=address of name 1 
[ DE=address of list entry J 



LA=faddrl ] ,HA= faddr21 
l(regl)I l(reg2)J 



PGRLSE 
(list form) 



MF=L[ / LA=addrl ] [, HA=addr2] 



PGRLSE 
(execute 
form) 



MF=(E, f listaddrl ) f,LA= f addrl }1 f ,HA= faddr2 
I(reg3) J [ l(regl)/J [ l(reg2)j 



POST 



ecb address[, completion code] 



Kregl[,reg2])][,T] 



. RC= [ number "1 
I 05) t 



(regll/regZD^TK, identifier name] 



external segment name 



DCB=dcb address [TCB=address][, ID=number] 

[ / SDATA=(code for control program blocks)] 

[, PDATA=(code for problem program areas)] 

,STORAGE=(starting address, ending address,...) 
,LIST=addressof list 



SNAP 
(list form) 



[DCB=address] [,ID=number] [,SDATA=(code)] 



[,PDATA=(code)] 



, STORAGE=(address, address, 
,LIST=address 



) ,MF=L 



SNAP 

(execute 

form) 



[DCB=address] [,TCB= faddressl ] [,ID=number] 
I 'S' J 



[,PDATA=code] [,SDATA=code] 



,STORAGE=(address, address, . . .) 
,LIST=address 



,MF=(E, fcontrol program list address 1 ) 
t 0) 1 



[interruption exit address, (interruptions)] 



3-6 OS/VS1 Programmer's Reference Digest 



Supervisor Macro Outlines (cont'd) 



SPIE 
(list form) 



[interruption exit address] [, (interruptions)],MF=L 



SPIE 

(execute 

form) 



[interruption exit address] [, (interruptions)] 
,MF=(E, f control program list address! ) 

I 0) I 



I 1 J, OV I [ , PARAM=I ist address] 

I exit address! |,CT I 



r,XCTL=|YESl] f,PURGE= f 

[ M I | 



= [ QUIESCE Tl r,ASYNCH= fYESl 
HALT II I iNOJ. 

I NONE 



STAE 
(list form) 



[exit address] [, PARAM=I ist address] 



PURGE= [QUIESCE lir,ASYNCH= /YES 1| ,MF=L 
HATT ML iNOl 



STAE 

(execute 

form) 



f 1 I , OV I [, PARAM=I ist address] 

lexit address J | ,CT | 



[• XCTL 1H)] 



,PURGE= [ QUIESCE 
HALT 
I NONE . 



,ASYNCH= {YES 
I NO 



,MF=(E, [ remote list address 1 ) 

I 0) I 



[ REAL [, timer completion exit address] 1 
I TASK [, timer completion exit address] | 
I WAIT " J 



,DINTVL=address ' 
,BINTVL=address 
,TUINTVL=address 
,TOD=address 



[value] 
ID= addr 



3,NTVL = Cddrl 



[(BIN, addr) 

TEST= (DEC, addr) 

l(MIC,addr) 



\ [,REPLACE=YES] 



CANCEL=YES [(BIN, addr)' 

,CANCEL=YES, TEST= (DEC,addr) 

I (MIC, addr) J 



,EXIT=addr[,SVAREA= (^o)] 
ERRET=addr] 



Note : ID=ALL can be used with CANCEL if TEST is not specified; 

ID=ALL is defaulted if CANCEL appears alone. ALL is invalid 
for all other uses of ID. 



Section 3: Supervisor Information 3-7 



Supervisor Macro Outlines (cont'd) 





[lOvalue] 


STIMERE 


r,BINTVL=valuel 


(list 
form) 


,DINTVL=value 
L,MICVL=value J 




,ECB=addr fYF5l 
,EXIT=addr[,SVAREA= r£ M 
L ,MF=L INUJ J 




n^eii 


STIMERE 
(execute 
form) 


.' MicvL =(=ddr). 






[,REPLACE=YES] 




f",EC&=addr 1 
,EXIT=addr[ / SVAREA=J^gJ] 




[,ERRET=addr] 

,MF=(E, ( parameter list address 1 

I 0) J 


TIME 


' DEC 
BIN 
TU 
MIC, address 




TTIMER 


[CANCEL] 


WAIT 


[number of events, ] f EC B=address 1 
I ECBLIST=address J 


WAITR 


[number of events, ] f ECB=address 1 
I ECBLIST=address J 


WTL 


'message' 


WTL 
(list form) 


'message', MF=L 



3-8 OS/VS1 Programmer's Reference Digest 



Supervisor Macro Outlines (cont'd) 



WTL 

(execute 

form) 



MF=(E, (control program list addressl ) 
( (D I 



('message' I 

('text' [, line type]),... f 

f,HOUTCDE-{wmWi, number],,. 01 
[,DESO=rtu*iber} 



WTO 
(list form) 



J (" text' [ f line type]),...) 
I'message 1 I 

i,R6UTCDNwifnfaert r nwBber*.,])Ji 

f,DESC^wmberJ 

,mf=l 



WTO 

(execute 

form) 



MF=(E, {control program list address)) 

I 0) ' 



'message' , reply address, length of reply 

'ecb address'!, RbUTCD£=(nunAer|,rwmber.. '♦])]; 

[,DESC=n umber}' 



WTOR 
(list form) 



'message', [reply address], [length of reply] 

, [ecb address] |, 80UTCOE*<nomberf f ootribef ',„})}' 



WTOR 

(execute 

form) 



, [reply address], [length of reply], [ecb address] 



,MF=(E, (control program list addressl ) 
I (1) / 



[(regl[,reg2])], f EP=symbol 1 

| EPLOC=address of name I 
I DE=address of list entry J 

[,DCB=dcb address] 



XCTL 
(list form) 



EP=symbol 

EPLOC=address of name 
DE=address of list entry. 



[,DCB=dcb address], SF=L 



XCTL 

(execute 

form) 



[(regl[,reg2])] f,EP=symbol i 

] , EPLCC=address of name I 
DE=address of list entry J 

[, DCB=dcb address] 

,MF=(E, f problem program list address 1 ) 
I (1) / 

,SF=(E, r control program list address 1 ) 
I 05) I 

,MF=(E {addressl )SF=(E, ("address 1 ) 
I (1) J I 05) I 



I Note: Shaded area for Multiple Console Support. 



Section 3: Supervisor Information 3-9 



Supervisor Macro Parameter Notation 


Abbreviation 




Meaning 


Sym 




Any symbol valid in the assembler language. 


Dec Dig 




Any decimal digits, up to the value indicated in 
the associated macro instruction description. 
If both Sym and Dec Dig are checked, an 
absolute expression is also allowed. 


Register 




A general register, always coded within 
parentheses, as follows: 




(2-12) - 


one of the general registers 2 through 12, 
previously loaded with the right-adjusted value 
or address indicated in the macro-instruction 
description. The unused high-order bits must be 
set to zero. The register may be designated 
symbolically or with an absolute expression. 




0)- 


general register 1, previously loaded as 
indicated above. Designate the register as (1) 
only. 




(0)- 


general register 0, previously loaded as 
indicated above. Designate the register as (0) 
only. 


RX type 




Any address that is valid in an RX-type 
instruction (e.g., LA) may be designated. 


A - Type 




Any address that may be written in an A-type 


Adcon Type 




address constant may be designated. 



3-10 OS/VS1 Programmer's Reference Digest 



Summary of Supervisor Operands 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Dec 
Dig 


Register 


RX- 
type 


A-type 
Ad con 
type 


(2- 
12) 


(1) 


(0) 


ABEND 


completion code 


S 


S 


S 


S 








DUMP 


written as shown 


STEP 


written as shown 


ATTACH 


DCB 






SE 






E 


SL 


DE= 






SE 






E 


SL 


DPMOD= 


SLE 


SLE 


SE 










ECB= 






SE 






E 


SL 


EP= 


SLE 














EPLOC= 






SE 






E 


SL 


ETXR= 






SE 






E 


SL 


FPREGSA= 


YES or NO 


LPMOD= 


SLE 


SLE 


SE 










PARAM- 






SE 






E 


S 


TQE= 


YES or NO 


VL=1 


written as shown 


CALL 


entry point name 


SE 














address parameters 






SE 






E 


SL 


VL 


written as shown 


ID= 


SE 


SE 












CHAP 


priority change value 


S 


S 


S 




s 






tcb location address 






S 


s 




s 




DELETE 


DE= 






S 




s 


s 




EP= 


S 














EPLOC= 






S 




s 


s 





S=standard; L=list; E=execute 



Section 3 : Supervisor Information 3-11 



Summary of Supervisor Operands (cont'd) 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Dec 
Dig 


Register 


RX- 
type 


A-type 
Ad con 
type 


(2- 
12) 


0) 


(0) 


DEQ 


qname address 






SE 






E 


SL 


rname address 






SE 






E 


SL 


rname length 


SLE 


SLE 


SE 










STEP or SYSTEM 


written as shown 


RET=HAVE 


written as shown 


RET=NONE 


written as shown (E form only) 


DETACH 


tcb location address 


S 




S 


s 




S 




DOM 


MSG= 






S 


s 








MSGLIST= 


S 




S 


s 




S 




DXR 


regl 


S 


S 












reg2 


S 


S 












ENQ 


qname address 






SE 






E 


SL 


rname address 






SE 






E 


SL 


EorS 


written as shown 


rname length 


SLE 


SLE 


SE 










STEP or SYSTEM 


written as shown 


RET= 


TEST, USE, CHNG, or HAVE 


RET=NONE 


written as shown (E form only) 


FREEMAIN 


E, R or V 


written as shown 


A=(with E, L, or V) 






SE 






E 


SL 


A=(with R) 






S 


s 




S 




LV=(with E) 


SLE 


SLE 


SE 










LV=(with R) 


S 


S 


S 




s 






SP=(with E or V) 


SLE 


SLE 


SE 










SP=(with R) 


S 


S 


S 




s 






GETMAIN 


EC, EU, VC, or VU 


refer to macro description 


A= 






SE 






E 


SL 


BNDRY= 


DBLWD or PAGE 


LA= 






SE 






E 


SL 



3-12 OS/VS1 Programmer's Reference Digest 



Summary of Supervisor Operands (cont'd) 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Dec 
Dig 


Register 


RX- 
type 


A-type 
Ad con 
type 


(2- 
12) 


(1) 


(0) 


GETMAIN 
(cont'd) 


LV=(with E) 


SLE 


SLE 


SE 










LV(with R) 


S 


S 


S 




s 






SP=(with EorV) 


SLE 


SLE 


SE 










SP=(w!th R) 


S 


S 


S 




s 






GTRACE 


DATA= 






S 






S 


SLE 


LNG= 


SLE 


SLE 


SLE 










FID- 


SLE 


SLE 


SLE 










ID= 


SE 


SE 












IDENTIFY 


ENTRY- 






S 


s 




S 




EP- 


S 














EPLOC= 






S 




s 


S 




LINK 


DCB- 






SE 






E 


SL 


DE= 






SE 






E 


SL 


EP- 


SLE 














EPLOC- 






SE 






E 


SL 


ID= 


SE 


SE 












PARAM= 






SE 






E 


S 


VL=1 


written as shown 


LOAD 


DCB= 






S 


s 




S 




DE- 






S 




s 


S 




EP- 


S 














EPLOC- 






S 




s 


S 




PGRLSE 


LA- 






SE 




SE 




SLE 


HA= 






SE 


SE 






SLE 


list addr- 












E 




reg 3= 






e' 










POST 


ecb address 






S 


s 




S 




completion code 


S 


S 


S 




s 







Section 3 : Supervisor Information 3-13 



Summary of Supervisor Operands (cont'd) 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Dec 
Dig 


Register 


RX- 
type 


A-type 
Ad con 
type 


(2- 
12) 


0) 


(0) 


RETURN 


(regl,reg2) 




S 












T 


written as shown 


RC= 


S 


S 


or (15) 


SAVE 


(regl,reg2) 




S 












T 


written as shown 


identifier name 


character string or * 


SEGWT 


external segment name 


S 














SNAP 


DCB= 






SE 






E 


SL 


ID= 


SLE 


SLE 


SE 










LIST= 






SE 






E 


SL 


PDATA 


refer to macro description 


SDATA 


refer to macro description 


STORAGE 






SE 






E 


SL 


TCB= 






SE 






•E 


S 


SPIE 


interruption exit address 






SE 






E 


SL 


interruptions 




SLE 












STIMER 


REAL, TASK or WAIT 


written as shown 


timer completion exit addr 






S 




s 


s 




BINTVL= 






s 


s 




s 




DINTVL= 






s 


s 




S 




TOD= 






s 


s 




S 




TUINTVL= 






s 


s 




s 





3-14 OS/VS1 Programmer's Reference Digest 



Summary of Supervisor Operands (cont'd) 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Dec 
Dig 


Register 


RX- 
type 


A-type 
Adcon 
type 


(2- 
12) 


(1) 


(0) 


STIMERE 


ID=addr 


SE 




SE 






SE 




BINTVL=addr 


SE 




SE 






SE 




DINTVL=addr 


SE 




SE 






SE 




MICVL=addr 


SE 




SE 






SE 




ID=value 




SLE 












BINTVL=value 




SLE 












DINTVL=value 




SLE 












MICVL=value 




SLE 












ID=ALL 


written as shown (S form only) 


REPLACE=YES 


written as shown (SE forms only) 


TEST=( BIN DEC MIC 
,addr) 


S 




S 






S 




CANCEL=YES 


written as shown (S form only) 


ECB=addr 


SLE 




SLE 






SLE 




EXIT=addr 


SLE 




SLE 






SLE 




SVAREA= 


YES or NO 


ERRET=addr 


SE 




SE 






SE 




TIME 


DEC or BIN or TU 


written as shown 


MIC 


written as shown 


address 






S 




S 


S 




TTIMER 


CANCEL 


written as shown 


TU 


written as shown 



Section 3: Supervisor Information 3-15 



Summary of Supervisor Operands (cont'd) 



MACRO 
INSTRUCTION 


OPERANDS 


WRITTEN AS 


Sym 


Deg 
Dig 


Register 


RX- 

type 


A-type 
Adcon 
type 


(2- 
12) 


(1) 


(0) 


WAIT 
WA1TR 


number of events 


S 


S 


S 




s 






ECB= 






s 


S 




S 




ECBLIST= 






s 


s 




S 




WTL 


message 


any message within apostrophes 


WTO 


message 


any message within apostrophes 


text 


any text within apostrophes 


line type 


C,L,D,DE, orE 


ROUTCDE= 




SL 












DESC= 




SL 












WTOR 


message 


any message within apostrophes 


reply address 






SE 






E 


SL 


length of reply 


SLE 


SLE 


SE 










ecb address 






SE 






E 


SL 


ROUTCDE= 




SL 












DESC= 




SL 












XCTL 


(regl,reg2) 




SE 








E 


S 


DCB= 






SE 






E 


SL 


DE= 






SE 






E 


SL 


EP= 


SLE 














EPLOC= 






SE 






E 


SL 



3-16 OS/VS 1 Programmer's Reference Digest 



Programming Conventions for SVC Routines 



Conventions 


Type 1 


Type 2 


Type 3 


Type 4 


Part of resident 
control program 


Yes 


Yes 


No 


No 


Size of routine 


Any 


Any 


<2048 bytes 


Each load 
module <2048 
bytes 


Reenterable routine 


Optional, but 
must be 
serially 
reusable 


Yes 


Yes 


Yes 


May allow Inter- 
ruptions 


Yes 


Yes 


Yes 


Yes 


Entry point 


Must be the first byte of the routine or 
module, and must be on a double-wore 


load 
boundary 


Number of routine 


Numbers assigned to your SVC routines should 
be in descending order from 255 through 200 


Name of routine 


IGCnnn 


IGCnnn 


IGCOOnnn 


IGCssnnn 


Register contents 
at entry time 


Registers 3, 4, 5, and 14 contain communication 
pointers; registers 0, 1, and 15 are parameter 
registers 


May contain reloca- 
table data 


Yes 


Yes 


No 


No 


Can supervisor re- 
quest block (SVRB) 
be extended 


Not 
applicable 


Yes 


Yes 


Yes 


May issue WAIT 
macro instruction 


No 


Yes 


Yes 


Yes 


May issue XCTL 
macro instruction 


No 


No 


No 


Yes 


May issue SVC s 


No 


Yes 


Yes 


Yes 


Exit from SVC Routin 


e Branch using return register 14 


Method of abnormal 
termination 


Use resident 
abnormal 
termination 
routine 


Use ABEND 
macro instruction or 
resident abnormal 
termination routine 



Section 3: Supervisor Information 3-17 



SVC Register Contents 



Dec (hex) 
No. 


Type 


Macro 


Register 


Register 1 


0(0) 


1 


EXCP 




IOB address 


UD 


1 


WAIT 


Event count 


ECB address of 2's complement 
of ECB list address 


KD 


1 


PRTOV 






2(2) 


1 


POST 


Completion code 


ECB address or parm list address 
with high-order bit on 


3(3) 


1 


EXIT 






4(4) 


1 


GETMAIN 




Parameter list address 


5(5) 


1 


FREEMAiN 




Parameter list address 


6(6) 


II 


LINK 






7(7). 


II 


XCTL 






8(8) 


II 


LOAD 


Address of entry point 
address 


DCB address 


9(9) 


II 


DELETE 


Address of program name 




10(A) 


1 


GETMAIN 

or 
FREEMAIN 


Subpool number (byte 0), 
length (bytes 1-3) 


If negative, indicates GETMAIN. 
If positive, contains address 
of area to be freed 


1KB) 


1 


TIME 


Pointer to a doubleword 
to store TOD if MIC 
specified 


Time units code 


12(C) 


II 


SYNCH 






13(D) 


IV 


ABEND 




Completion code 


14(E) 


II 


SPIE 




PICA address 


15(F) 


1 


ERREXCP 




Address of request queue 
element 


16(10) 


III 


PURGE 






17(11) 


III 


RESTORE 




IOB chain address 


18(12) 


II 


BLDL/FIND 


Address of build list 


DCB address 


19(13) 


IV 


OPEN 




Address of parameter list of 
DCB addresses 


20(14) 


IV 


CLOSE 




Address of parameter list of 
DCB addresses 


21(15) 


III 


STOW 


Parameter list address 


DCB address 



3-18 OS/ VS 1 Programmer's Reference Digest 



SVC Register Contents (cont'd) 



Dec (hex) 
No. 


Type 


Macro 


Register 


Register 1 


22(16) 


IV 


OPEN 
TYPE=J 




Address of parameter list of 
DCB addresses 


23(17) 


IV 


CLOSE 
TYPE=T 




Address of parameter list of 
DCB addresses 


24(18) 


III 


DEVTYPE 




ddname address 


25(19) 


III 


TRKBAL 




DCB address 


26(1A) 


IV 


CATALOG 




Parameter list address 


26(1 A) 


IV 


INDEX 




Parameter list address 


26(1 A) 


IV 


LOCATE 




Parameter list address 


27(1 B) 


III 


OBTAIN 




Parameter list address 


28(1 C) 


IV 


CVOL 






29(1 D) 


IV 


SCRATCH 


UCB address 


Parameter list address 


30(1 E) 


IV 


RENAME 


UCB address 


Parameter list address 


31 (IF) 


IV 


FEOV 




DCB address 


32(20) 


IV 


ALLOC 




Address of UCB list 


33(21) 


III 


IOHALT 




UCB address 


34(22) 


IV 


MGCR 
(MAST CMD 
EXCP) 






34(22) 


IV 


QEDIT 






35(23) 


IV 


WTO 




Message address 


35(23) 


IV 


WTOR 




Message address 


36(24) 


IV 


WTL 




Message address 


37(25) 


II 


SEGLD 




Segment name addr 


37(25) 


II 


SEGWT 




Segment name addr 


38(26) 




Reserved 


39(27) 


III 


LABEL 




Parameter list address 


40(28) 


II 


EXTRACT 




Parameter list address. 


41 (29) 


II 


IDENTIFY 


Entry point name address 


Size of work area In 
doublewords 


42(2A) 


II 


ATTACH 




May contain user parm list 
address 


43(2B) 


III 


CIRB 


Entry point address 


Size of work area in 
doublewords 


43(2B) 


II 


DIRB 







Section 3: Supervisor Information 3-19 



SVC Register Contents (cont'd) 



Dec (hex) 
No. 


Type 


Macro 


Register 


Register 1 


44(2C) 


III 


CHAP 


+lncrease priority 

-Decrease priority 


TCB address 


45(2D) 


II 


OVLYBRCH 






46(2 E) 


1 


TTIMER 




1: Cancel 


47(2F) 


II 


STIMER 


Exit address (Option 
flags in high order byte) 


Timer interval address 


48(30) 


II 


DEQ 




DEQ parameter list address 


49(31) 




Reservec 






50(32) 




Reservec 






51 (33) 


IV 


SNAP 




Parameter list address 


52(34) 


IV 


RESTART 




DCB address 


53(35; 


III 


RELEX 


Key address 


DCB address 


54(36) 


II 


DISABLE 






55(37) 


IV 


EOV 


IOB address 


DCB address 


56(38) 


II 


ENQ 




ENQ parameter list address 


57(39) 


III 


FREEDBUF 


DECB address 


DCB address 


58(3A) 


II 


RELBUF 




DCB address 


58(3A) 


II 


REQBUF 




DCB address 


59(3B) 


IV 


OLTEP 






60(3C) 


III 


STAE 


Create SCB 
4 Cancel SCB 
8 Overlay SCB 


Parameter list address 


61(3D) 




Reservec 






62(3E) 


III 


DETACH 




TCB address location 


63(3F) 


IV 


CHKPT 




DCB address 


64(40) 


III 


RDJFCB 




Address of parameter list of 
DCB addresses 


65(41) 




Reservec 






66(42) 


IV 


BTAMTEST 






68(44) 


IV 


SYNADAF 


Same as reg on entry 
to SYNAD 


Same as reg 1 on entry to 
SYNAD 


68(44) 


IV 


SYNADRLS 






69(45) 


III 


BSP 




DCB address 


70(46) 


II 


GSERV 




Parameter list address 



3-20 OS/VS1 Programmer's Reference Digest 



SVC Register Contents (cont'd) 



Dec (hex) 
No. 


Type 


Macro 


Register 


Register 1 


71(47) 


IV 


RLSEBFR 




Parameter list address 


71(47) 


IV 


ASGNBRF 




Parameter list address 


71(47) 


IV 


BUFINQ 




Parameter list address 


72(48) 


IV 


CHATR 




Parameter list address 


73(49) 


IV 


SPAR 




Parameter list address 


74(4A) 


IV 


DAR 




Parameter list address 


75(43) 


III 


DQUEUE 




Parameter list address 


76(4C) 


IV 


IFBSTAT 






77(4D) 




Reserved 




78(4E) 


,v 


DSCAN 






SO (50) 




Reserved 




81(51) 


IV 


SETPRT 






82(52) 


IV 


DASDR 






83(53) 


III 


SMFV/TM 




Message address 


84(5-1) 


1 


GRAPHICS 






85(55) 


IV 


DDRSWAP 






86(56) 


IV 


ATLAS 




Parameter list address 


87(57) 


III 


DOM 




DOM message Id if reg 0=0 
A pointer to a list of DOM 
message Ids if reg negative. 


88(58) 


III 


MOD88 


Routine Code 


DCB address 


89(59) 


III 


EMSRV 




Parameter list address 


90(5A) 


IV 


XQMNGR 


Address of list of ECB/ 
IOB pointers (optional) 


QMPA address 


91(53) 


IV 


VOLSTAT 


DCB address 


Zero: issued by CLOSE 
Non-zero: issued by EOV 


92(5C)- K 


"(65) 


Reserved 




102(66) 


1 


AQCTL 




Parameter list address 


103(67) 


III 


XLATE 






104(68) 


IV 


TOPCTL 






105(69) 


III 


IMAGLIB 






106(6A) 




Reserved 




107(6B) 


1 


MODESET 


Parameter list address 


108(6C) 




Reserved 





Section 3: Supervisor Information 3-21 



SVC Register Contents (cont'd) 



Dec (hex) 
No. 


Type 


Macro 


Register 


Register 1 


109(6D) 


II 


Extended 

SVC Router 

(ESR) 


Parameters to ESR 


Parameters to ESR 


110(6E) 




Reserved 




1 1 1 (6F) 


11 


JECS 




Parameter List address 


112(70) 


1 


PGRLSE 


Low address 


High address 


113(71) 


1 


SIR 


ECB address or pointer 
to parameter list or 
contents ignored 


Parameter word or PA 


114(72) 


1 


EXCPVR 




Parameter List address 


115(73) 




Reserved 




116(74) 


1 


Extended 
SVC Router 
(ESR) 


Parameters to ESR 


Parameters to ESR 


117(75) 


IV 


DEBCHEK 


Function 


\ DCB 


118(76) 


1 


AT 






119(77) 


2 


TESTAUTH 






122(7A) 


3 


ESR 







3-22 OS/VS1 Programmer's Reference Digest 



SVC Directory 



Dec. (hex) 


Type 


Macro 


Module Nome 


No. 








(0) 




EXCP 


IEAIOS00 


1 0) 




WAIT 


IEAAWT 


2 (2) 




POST 


IEAAPT 


3 (3) 




EXIT 


IEAATA00 


4 (4) 




GETMAIN 


IEAAMS00 


5 (5) 




FREEMAIN 


IEAAMS00 


6 (6) 


2 


LINK 


IEAATC00 


7 (7) 


2 


XCTL 


IEAATC00 


8 (3) 


2 


LOAD 


IEAATCC0 


9 (9) 


2 


DELETE 


IEAJDL00 


10(A) 


1 


REGMAIN 


IEAAMS00 


1KB) 


1 


TIME 


IEA0RT01 


12(C) 


2 


SYNCH 


IEAASY00 


13(D) 


4 


ABEND 


IEANTM00- 
[EANTMOM 


14(E) 


2 


SPIE 


IEAAPX00 


15(F) 


1 


ERREXCP 


IEAIOS00 


16(10) 


3 


PURGE 


IECIPRL2 


17(11) 


3 


RESTORE 


IGC0001G 


18(12) 


2 


BLDL/FIND 


IGC018 


19(13) 


4 


OPEN 


IGC00011 


20(14) 


4 


CLOSE 


IGC00020 


21(15) 


3 


STOW 


IGC0002A 


22(16) 


4 


OPEN 
TYPE=J 


IGC0002B 


23(17) 


4 


CLOSE 
TYPE=T 


IGC0002C 


24(18) 


3 


DEVTYPE 


IGC0002D 


25(19) 


3 


TRKBAL 


IGC0002E 


26(1 A) 


4 


CATALOG 


IGC0002F 


26(1 A) 


4 


INDEX 


IGC0002F 



Section 3: Supervisor Information 3-23 



SVC Directory (cont'd) 



Dec. (hex) 


Type 


Macro 


Module Name 


No. 








26(1 A) 


4 


LOCATE 


IGC0002F 


27(1 B) 


3 


OBTAIN 


IGC0002G 


28(1 C) 


4 


CVOL 


IGC0002H 


29(1 D) 


4 


SCRATCH 


IGC0002I 


30(1 E) 


4 


RENAME 


IGC00030 


31 (IF) 


4 


FEOV 


IGC0003A 


32(20) 


4 


ALLOC 


IGC0003B 


33(21) 


3 


IOHALT 


IGC0003C 


34(22) 


4 


MGCR 


IEE0303D 


34(22) 


4 


QEDIT 


IEE0303D 


35(23) 


4 


WTO 


IEEMFWTO 


35(23) 


4 


WTOR 


IEEMFWTO 


36(24) 


4 


WTL 


IEE0303F 


37(25) 


2 


SEGLD 


IEWSUOVR 


37(25) 


2 


SEGWT 


IEWSUOVR 


39(27) 


3 


LABEL 


IGC00031 


40(28) 


2 


EXTRACT 


IEABXR00 


41(29) 


2 


IDENTIFY 


IEAAID00 


42(2A) 


2 


ATTACH 


IEAQAT 


43(2B) 


2 


CIRB 


IEAAEF00 


43(2B) 


2 


DIRB 


IEAAEF00 


44(2C) 


1 


CHAP 


IEAQTB00 


45(2D) 


2 


OVLYBRCH 


IEWSVOVR 


46(2 E) 


1 


TTIMER 


IEA0ST01 


47(2F) 


2 


STIMER 


IEA0ST01 


48(30) 


2 


DEQ 


IEAGENQ1 


51(33) 


4 


SNAP 


IEAAAD00- 
IEAAAD05and 
IEAAAD0A- 
IEAAAD0L 


52(34) . 


4 


RESTART 


IEFVSMBR 


53(35) 


3 


RELEX 


IGC0005C 



3-24 OS/VS1 Programmer's Reference Digest 



SVC Directory (cont'd) 




Dec. (hex) 


Type 


Macro 


Module Name 


No. 








54(36) 


2 


DISABLE 


IGC054 


55(37) 


4 


EOV 


IGC0005E 


56(38) 


2 


ENQ 


IEAGENQ1 


57(39) 


3 


FREEDBUF 


IGC0005G 


58(3A) 


2 


RELBUF 


IGC058 


58(3A) 


2 


REQBUF 


IGC058 


59(3B) 


4 


OLTEP 


1GC0005I 


60 (3 C) 


3 


STAE 


IEAAST00 


62(3 E) 


3 


DETACH 


IEAGED02 


63(3F) 


4 


CHKPT 


IHJACP00 


64(40) 


3 


RDJFCB 


IGC0006D 


66(42) 


4 


BTAMTEST 


IGC0006E 


68(44) 


4 


SYNADAF 


IGC0006H 


68(44) 


4 


SYNADRLS 


IGC0006H 


69(45) 


3 


BSP 


IGC0006I 


70(46) 


2 


GSERV 


IGC070 


71(47) 


4 


RLSEBFR 


IGC0007A 


71(47) 


4 


ASGNBRF 


IGC0007A 


71(47) 


4 


BUFINQ 


IGC0007A 


72(48) 


4 


CHATR 


IEECMCTR 


73(49) 


4 


SPAR 


IGC0C07C 


74(4A) 


4 


DAR 


IEADTM22- 
IEADTM23 


75 (4 B) 


3 


DQUEUE 


IGC0007E 


76(4C) 


3 


IFBSTAT 


IFBSTAT 


78(4E) 


4 


DSCAN 


IGC0007H 


81(51) 


4 


SETPRT 


IGC0008A 


82(52) 


4 


DASDR 


IGC0008B 


83(53) 


3 


SMFWTM 


IEESMF8C 


84(54) 


1 


GRAPHICS 


IGC084 


85(55) 


4 


DDRSWAP 


IGC0008E 



Section 3: Supervisor Information 3-25 



SVC Directory 


(cont'd) 




Dec. (hex) 
No. 


Type 


Macro 


Module Name 


86(56) 


4 


ATLAS 


IGC0008F 


87(57) 


3 


DOM 


IEECXDOM 


88(58) 


3 


MOD88 


IGC0008H 


89(59) 


3 


EMSRV 


IGC0008I 


90(5A) 


4 


XQMNGR 


IEFXQM00 


91 (5B) 


3 


VOLSTAT 


IGC0009A 


102(66) 


1 


AQCTL 


IEDQEB 


103(67) 


2/3 


XLATE 


IGG0010C 


104(68) 


4 


TOPCTL 


IEDQEB 


105(69) 


3 


IMAGLlB 


IGC0010E 


107(6B) 


1 


MODESET 


IEAVMODE 


109(6D) 


2 


ESR (extended 
SVC router) 


IGC116 


111(6F) 


2 


J ECS 


IFGA2016 


112(70) 


1 


PGRLSE 


IEAAIH00 


113(71) 


1 


SIR 


IEAAIH00 


114(72) 


1 


EXCPVR 


IEAIOS00 


116(74) 


1 


ESR 


IGC116 


117(75) 


4 


DEBCHEK 


IFGDEBCHK 


118(76) 


1 


AT 


IEAAIH00 


119(77) 


2 


TESTAUTH 


IEAVTEST 


122(7A) 


3 


ESR 


IGC116 



3*26 OS/VS1 Programmer's Reference Digest 



Load Module Control 



Explanation of Style 



Words in all capitals are coded as shown; 
appropriate values are to be substituted for 
words in lower case letters. Brackets, [ J, 
enclose operands that may be used or 
omitted as required; stacking within braces, 
{ }, is used to indicate a choice of 

operands or values. Underlining, , 

indicates a default value. 



Footnotes : 

* In full-word on full-word boundary 
** In double-word on double-word boundary 
+ Left justified in double-word on byte 

boundary 
o Multiple of eight; value given in bytes 



Load Module Control 



Pass control 


CALL 


entry point name (, (address parameter [, address parameter!. . .)[, VL] ] 
[,ID=0 to 65535] 


Dynamically 
load and 
initiate 
execution 


LINK 


f EP=entry point name ^ 

/ EPLOC=address of entry point name" 1 " > [,DCB=dcb address] 
^DE=address of list entry J 

|,PARAM=(address parameter [, address parameter],. . .) [,VL=1 ] ] 

[,ID=0to 65535] 


Transfer 
control 


XCTL 


f EP=entry point name 1 

[rcnge of registers to be restored], 1 EPLOC=address of entry point name J 

( DE=address of list entry ) 

[,DCB=dcb address] 


Dynamically 


LOAD 


f EP^entry point name ^ 

I EPLOC=address of entry point name + > [,DCB=dcb address] 
(J)E=address of list entry J 


Delete 


DELETE 


reentry point name "1 
< EPLOC=adn'ress of entry point name + ) 
|DE=address of list entry J 


Identify 
embedded 
entry point 


IDENTIFY 


fEP=entry point name 1 , ENTRY=entry point address 
\ EPLOC=address of entry point name+J 


Load 

overlay 

segment 


SEGWT 


external segment name 



Section 3: Supervisor Information 3-27 



Synchronization 



Wait for 
event 


WAIT 


[number of events, J f EC6=ecb address ^ 
\ECBLIST=address of list of ecb oddresses*J 


Wait for event 
while lower 
priority task 
is executed 


WAITR 


[number of events, J / ECB=ecb address \ 
\^ECBLIST=address of list of ecb addresses* J 


Post event 
completion 


POST 


ecb address [, completion code] 


Request 
control of 
serially 
reusable 
resource 


ENQ 




(qname address, rname address, fY], [rname length], (IySTEmI ,...) 

Ill m J 

~,RET=TEST "j 
,RET=USE 
,RET=HAVE 

,ret=chngJ 


Release 
serially 
reusable 
resource 


DEQ 


(qname address, rna 
[,RET=HAVE1 


me address, [rname length], ["STEP "],...) 
L SYSTEM J 




E means exclusive control ~) , , , , - 
S means shared control J" default .s E 

SYSTEM means resource used by more than one job 
STEP means resource used by issuing job 






Set interval 
timer 


STIMER 


J REAL, [address of Interval end routine] 1 
( TASK, [address of interval end routine] ) 
^WAIT J 

f,DINTVL=address of decimal interval** ~"| 
J ,BINTVL=address of binary interval in seconds* I 
S , TUI NTVL=address of binary interval in timer units* ( 
1 ,TOD=address of fime-of-day of interval end** J 


Test interval 
timer 


TTIMER 


[CANCEL] [,TU] 


TIME AND TIME INTERVALS FOR TTIMER AND STIMER 


Decimal (DINTVL operands): Binary in seconds (BINTVL operands): 

Eight unpacked decimal digits in format Unsigned 32-bit binary number in a full-word on 
HHMMSSth full-word boundary; least significant bit has a 
HH = hours in 24-hour clock value of 0.01 second 
MM = minutes 

SS = seconds Binary in timer units (TU or TUINTVL operands): 
t = tenths of seconds Unsigned 32-bit binary number in a full-word on 
h = hundredths of seconds full-word boundary; least significant bit has a 
value of 1 timer unit (1 timer unit = 26 micro- 
seconds) 



3 -28 OS/VS1 Programmer's Reference Digest 



Synchronization (cont'd) 



Set Interval 
extended 


STIMERE 


(value! 
ID^ addr 
IALL 1 1 










f' B,NTvL = \:i e ] ] 












,DINTVL= (^° r e ) I,REPLACE-YEsA 












< MICV1 "= (addrl J 








< 


f ((BIN, addr) 1 -v 
,TEST = (DEC, addr) 
l(MIC,oddr)l 


► 








,CANCEL=YES ((BIN.cddr) 1 [ 
,CANCEL=YES,TEST= (DEC,addr) 
V. l(MIC,addr)JJ j 








r,ECB=addr 1 
,EXIT=oddr|,SVAREA= {^"J ] 






|,ERRET=addr] 



ID=ALL can be used with CANCEL If TEST is r 
ID=AU is defaulted if CANCEL appears alone 



TIME INTERVALS FOR STIMERE 




Binary in seconds (BINTVL operand): 


Decimal (DINTVL operand): 


Eight unpacked decimal digits in 


format HHMMSSth 


31-bit positive binary number in a full-word on 


HH = hours in 24-hour clock 




full-word boundary; least significant bit has a 


MM = minutes 




value of 0.01 second 


SS = seconds 






r = tenths of seconds 




Binary in microseconds (MICVL operand): 


h = hundredths of seconds 




Unsigned 64-bit binary number in a double-word 
on a double-word boundary. Bit 51 is the low 
order digit of the interval value. 



Section 3: Supervisor Information 3-29 



Program Interrupt Control 

(see explanation of style • page 3-27) 



Enable and 
disable 
program 
interruptions 
and transfer 
control to 
Interruption 
exit routine 


SPIE 


[interruption exit rout 
[, (interruption type[, 


ine address] 
nterruption type],.. .)] 


INTERRUPTION TYPES FC 


RSPIE 


able 1 Type 

1 

i ,s 

1 n 

1 12 

1 13 

1 15 
1 


Meaning Maskable 

Fixed-point divide No 
Decimal overflow Yes 
Decimal divide No 
Exponent overflow No 
Exponent underflow Yes 
Significance Yes 
Floating-point divide No 


Type Meaning 

1 Operation 

2 Privileged operatic 

3 Execute 

4 Protection 

5 Addressing 

6 Specification 

7 Data 

8 Fixed-point overfl 


Mask 

No 
n No 
No 
No 
No 
No 
No 
aw Yes 


CONTROL BLOCKS 
Event control block (ECB) 
12 31 bit 




Program interrupt! 
1 


>n control area (PICA): 

2 3 4 5 bytes 


1 W 1 C [completion codel 




1 

1 pro- 
0000 1 gram 


exit routine 
address 


interruption 




W = wait flag 

C = completion flag 




Program interruption element (PIE): 
1 2 3 bytes 





4 
8 
12 
16 
20 
24 
28 


I PICA address 




Old Program Status Word 
after interruption 


Register 14 


Register 15 


Register 


Register 1 


Register 2 






by 















3-30 OS/VS1 Programmer's Reference Digest 



General Services 



%ee explanation of style • page 3-27) 










Delete 
message (s) 
from 
display 


DOM 


( MSG=register containing 24-bit, right-justified message number J 
) MSGLIST=address of list of fullwords, each a 24-bit, right-justified \ 
1 identification number of message to be deleted \ 


Write to 
operator 


WTO 


f 'message' 1 
l('text'[,linety P e|),...J 
|,ROUTCDE=(number [,numberj ,...)] 
[,DESC=number] 


Write to 
operator 

and wait 
for reply 


WTOR 


'message', address of reply area, length of reply, ecb address 
[,ROUTCDE=(number [, number) ,.,.)] (,DESC=message descriptor code(s)] 


Write to 
log 


WTL 


'message' 


Divide 
extended 
precision 
floating 
point number 


DXR 


register containing dividend, register containing divis 






Only registers and 4 can be used; 
they may be specified in either order. 










Get time 
and date 


TIME 




DEC 

BIN 

TU 

MIC, address 




TIME FOR TIM 


E 


Decimal (DEC 
Eight packed 
HHMMSSth 

HH = hours ir 
MM = minute 
SS = seconds 
t = tenths of 
h = hundredt 


operand): Binary in seconds (BIN operand): 

decimal digits in format Unsigned 32-bit binary number in a full-word on full- 
word boundary; least significant bit has a value of 
0.01 second 
24-hour clock 
s Binary in timer units (TU operand): 

Unsigned 32-bit binary number in a full-word on full- 
seconds word bondary; least significant bit has a value of 1 
hs of seconds t; mer unit (1 timer unit = 26 micro-seconds) 




Binary in microseconds (MIC operand): 
Unsigned 64-bit binary number in a double-word on a 
double-word boundary. Bit 51 is the low order digit 
of the interval value. 



Section 3: Supervisor Information 3-31 



General Services (cont'd) - Termination 

(tee explanation of style ■ page 3-27) 



Save 
register 

contents 


SAVE 




(range of registers to be stored) [,T] [/identifier] 








In SAVE, T means; save 

registers 14 and 15. 




storage 

and continue 


SNAP 


DCB=address of data control block [,TCB=address of TCB address*] 
[,ID=1 to 127] 






f AU l 
NUC 

[,SDATA=( /TRT \ 

w 


,ALL~ 

,NUC 

,TRT 

,CB 

,Q 


...)] 








Tall ^ 

PSW 1 
) REGS I 
[,PDATA=(\ SAorSAH / 
J PA or LPA or ALLPA 

l SPLS J 


~ALL 
,PSW 
,REGS 
,SAor ,SAH 
JPA or, LPA or, ALLPA 
,SPLS 


...)] 




SNAP SDATA VALUES 


ALL = all of the following fields 

NUC = all of nucleus except trace table 

TRT = trace table 

CB = TCB, active RBs, JPACQ, and MSS control blocks 


SNAP PDATA VALUES 


ALL = all of the following fields (assume SA and ALLPA) 

PSW = Program Status Word when SNAP was issued 

REGS = contents of general registers when SNAP was issued 

SA = linkage information and back trace 

SAH = linkage information only 

JPA = all virtual storage assigned to job step 

LPA = contents of resident reenterable load module 

ALLPA = JPA + LPA 

SPLS = contents of virtual storage subpools - 127 




[ , STORAGE = (starting address, ending address,...) | 
[_, LIST = address of list J 




Record 
trace data 


GTRACE 


DATA=address,LNG=number of bytes of data, 1 D=record ID 
[,FID=format identifier routine] 



Terminate 
normally 


RETURN 




[(range of registers to be restored)] [,T] 


ff,RC=0 to 40951] 
Ll,RC=(15) J J 




In RETURN, T means: place all ones 
in high-order byte of save area word 4. 










Terminate 
abnormally 


ABEND 


to 4095, [DUMP] [,STEP] 



3-32 OS/VS1 Programmer's Reference Digest 



Task Control 

(tee explanation of style - page 3-27) 



Dynamically 

initiate 
execution 


ATTACH 


1 EP=entry point name 1 

/ EPLOC=address of entry point name + \ [, DCB=dcb address] 
1 DE=address of name field of list er.tryj 

[,PARAM=(address parameter [, address parameter!...) [,VL= lj] 

[,ECB=eeb addressl [, ETXR=address of routine to be entered when] 
subtas!: terminates 

[,LPMOD=number subtracted from limit priority] 

[,DPMOD=signed number algebraically added to dispatching priority] 

|,FP REe SA«^§)l 


Delete 


DETACH 


address of tcb address* 


Change 
priority 


CHAP 


signed number to be algebraically added to dispatching priority 
f, address of tcb address"] 

L'' s ' J 




"~ ' j " S* indicates that the priority of the 
[active task is to be changed. 





Section 3: Supervisor Information 3-33 



Virtual Storage Allocation 

(see explanation of style - page 3-27) 



Allocate 
storage 



GETMAIN 
GETMAIN 



R,LV=lengfh° [,SP=0tol27] 



fECl,LV=length° 
lEUJ 



I VC l,LA=address of length© list 



[,SP=0 to 127] [,BNDRY=J DBLWD1] 
I PAGE J 



,A=address of specification list 



Release 
storage 



FREEMAIN 
FREEMAIN 



f R,LV=Length ,A=address of storage area address* list [,SP=0 to ]27] 

lR,SP=(0) 

f E,LV=length°],A=address of storage area address* list |,SP=0 to 127] 



MODE OPERANDS FOR GETMAIN AND FREEMAIN 



R=register type 

E=single area, fixed length 

V=single area, variable length 

Ounconditional 

C=conditional 



Release 
storage 



LA=low address of a 



j,HA=highaddress + l of a 



3-34 OS/VS1 Programmer's Reference Digest 



Overall Control Flow of Supervisor 



SVC 
Interruption 



/ 



Program Check 
Interruption 



External , 
Interruption 



SVC FLIH 



SVC SLIH 



4 L L 



i/o 

Interruption 



Machine Check 
Interruption 



SVC Routines 



Type 

1 



ABTERM 
Routine 

t 



Type 
2 



Type 1 Exit 
Routine 



Interrupted 
Routine 



Type 
3 



Type 
4 



(XCTL) 



To Dispatcher if 
Needed SVC 
Routine is not 
in Main Storage 



Program Check FLIH 

XI 



User-Written 

Error-Handling 

Routine 



-To Dispatcher if SVC 
Routine Issues an 
XCTL Macroinstruction 



E 



External FLIH 



Prologue 
Routine 



Page 

Exception 

Handler 



Exit Routine 



Transient 
Area Refresh 
Routine 

~T~ 



Service 

Interface 

Routine 



The exit routine is a Type 1 
SVC routine that does not pass 
control to the Type 1 exit 
routine. It is shown separately 
for illustrative purposes. 



Console 

Switch 

Routine 



ABTERM 
Routine 



n 



Timer 
FLIH 



I/O FLIH 

n 



I/O 
Supervisor 



ABTERM 
Routine 



L 



SERO 
Routine 



SER1 
Routine 



TT 

Wait Wait 
State State 



ABTERM 
Routine 



Dispatcher 



Routine Represented by 
Highest - Priority "Ready" TCB 



Retrieval of Library Routines 



SVC 

Routine 

Needed 



From Dispatcher 

I/O Error 

1i Routine I I 
{ Nee d ed \ { 



Transient 
Area Fetch 
Routine 



Exit Effector, 
Stage 3 



Overlay 
Supervisor 



Oth< 
Routine 



Link, Load, 
XCTL, and 
Synch Routine 



I Program Fetch Routine 



I/O Supervisor 



SVC 
Library 



' 1 t ' Routine ' — i t— 

Segment of f h Needed J | 

^ Program Fetch Routine 



[ 



I 



Link 

Library 

Job 



I/O Supervisor p ^ Library 



The Overlay Supervisor and the 
Link, Load, XCTL and Synch 
Routines are Both Type 2 SVC 
Routines 



Private 
Library 



Section 3: Supervisor Information 3-35 



General Flow Diagrams (Part 1 of 4) 

New PSW's 



l/O's 




I/O Interrupt 
Handler BALR to Post 



EXCP Supervisor 




Tunr on Wait 
Flag - Put RB 
Address in ECB 
Indicate Task Switch 



SVC IGC000 

SVC l IGC001 

SVC 2 IGC002 

SVC 3 IGC003 

SVC 4 IGC004 

SVC 5 IGC005 

SVC 9 IGC009 



EXCP 

WAIT 

POST 

EXIT 

GETMAIN 

FREEMAIN 

DELETE 



1 



SVC 10 IGC0010 REGMAIN 
SVC 15 IGC0015 ERREXCP 



<3 



P 





Put This TCB 

Address in the 

Next Dispatcher Slot 



^ 




Dequeue RB and 
FREEMAIN Storage 



_LPSW 
Return 



ABEND 

Code 

= FFFFFFFF 



Part 3 
Dispatcher 



«-LP5W (Return) 



3-36 OS/VS1 Programmer's Reference Digest 



General Flow Diagrams (Part 2 of 4) 



ABEND - 



SVC 3 



SVC 3 




Return Storage to 
Free Queue 



SVC 3 



SVC 3 



*~ ABEND 



Part 1 



Section 3: Supervisor Information 3-37 



General Flow Diagrams (Part 3 of 4) 

Type III SVC Handler 



Dispatcher . 



SLIH- 




~l 



U£ 



Second Level SVC Handler 




No ^Tvpe II 
SVC 



Yes 



BALR to SVRB 
Qeate 



Type II SVCs Type III and IV SVC's 



OPEN 

CLOSE 

CATALOG 

INDEX 

SCRATCH 

WTO 



PURGE 
RESTORE 
LOCATE 
OBTAIN 



Restore Registers 



BAL to Type II 



Initialize the 
Resume PSW to 
Entry Point 




Get Storage for 
Work Area and 
Program if 
Required 



L 



BAL to BLDL 




BAL to Fetch -*■ 



Yes 



li: 



SVRB Create 



"~l 



• ABEND 806 



L_.c: 



BLDL 



BLDL Subroutine to 
get TTR of Program on 
Disk - see Part 4 



■»- ABEND 106 



Fetch 



Link (Part 4) 

Load 

XCTL 

Find 

BLDL 

-SVC 3 











GETMAIN for 
SVRB 






* 






Initiate SVRB 
and Put it on 
RB Queue 



















Read Module 
into Storage 











No 



No 



Dispatcher 




LPSW from Resume 
PSW in RB 



Save Current 
Task Registers 



Find Highest 
Priority Task That 
Is not Waiting 



Locate First RB 
on Active 
Queue 




Refresh the 
Transient Area 



LPSW 
Wait 
-»- State 
if None 
Found 



3-38 OS/VS1 Programmer's Reference Digest 



IGC018(BLDL/FIND). 



IGC008 (LOAD) 
IGC007 (XCTL) 

IGC006(LINK) 



LINK, LOAD and XCTL 



SVC 8 



SVC 7 



SVC6 



Search Load List 
for Program to 
Go to 




BAL to Finch 



Move RB Chain 
Addr from Active 
RB to New RB 



Store New RB 
Addr in Active 
RB Chain Field 



Dequeue and 
FREEMAIN the 
XCTL'er 



Search Load List 
for Program to 
Go to 




BAL to Finch 



Search Load List 
for Program to Be 
Loaded 




BAL to Finch 



Queue up RB 
on Queue 



Increment the Use 
Count in the RB 



Place E/P Addr 
Into RO and Double- 
word Length in Rl 



-SVC3 



BLDl/FIND 



General Flow Diagrams (Part 4 of 4) 
BLDL Subroutine (Entered via BAL) 



GETMAIN for 
Work Area 




Set Return 
Reg to Point 
to FREEMAIN 



Branch to BLDL 
Subroutine 



j[ 




FREEMAIN 
Work Area 



-SVC3 



DZ 



Get BLDL 
List Entry 




Yes 



Set Up 
DCB, IOB, 
CCW, etc. 



Search Directory 
For Equal or 
High Key SVCO 



More 
Data 



Scan 
Block 



O 




Retun 




Move TTR 

and User Data to 

BLDL List 



Section 3: Supervisor Information 3-39 



3-40 OS/VS1 Programmer's Reference Digest 



Section 4: Data Management Information 



Data Management Macros 4-2 

Direct Access Device Capacities 4-13 

IBM Standard Tape Labels 4-14 

ANSI Standard Tape Labels 4-21 

Data Set Record Formats 4-29 

VSAM Macros for Data Access 4-33 

Flow of Control in QSAM, BSAM, and BPAM 4-38 

SAM Flow of Control for Open Executors 4-40 



Source Publications 



Details of data management macros for BSAM, BDAM, BPAM, 
BISAM, QSAM, and QISAM, as well as DASD track capacities, are 
found in OS/ VS Data Management Macro Instructions, GC26-3793. 

You can obtain additional tape label information from 

• OS/VS Tape Labels, GC26-3795 

Data set record format information is available in OS/VS Data 
Management Services Guide, GC26-3783. 

Additional VSAM information is available in OS/VS Virtual Storage 
Access Method (VSAM) Programmer's Guide, GC26-3838. 

For information about MICR/OCR data management refer to these 
publications: 

• OS Data Management Services and Macro Instructions for 
IBM 1419/1275, GC2 1-5006 

• OS Data Management Services and Macro Instructions for 
IBM 1285/1287/1288, GC21-5004 



Section 4: Data Management 4-1 



Data Management Macros - Introduction 

Data Management Macros for: 



BDAM 
BSAM 
BPAM 



BISAM 
QSAM 
QISAM 



Completion codes for D/M macros are contained in the low-order byte of general 
register 15. Unless otherwise indicated the letter codes used here mean: 

A - Successful completion. 

B - Completion, but one or more errors occurred that may invalidate 
the results of macro execution. 

C - Permanent I/O error 

D - Track, block, or device address not within data set. 

E - Not complete or no operation performed. 



A/M 


Macro 


Parameters 


Completion 
Codes 


BPAM 


BLDL 


(deb addressi , (list address! 
{ (1-12) } { (2-12) V 
( (0) ) ( (0) ) 


00 = A 
04- B 
08 = C 


BSAM 


BSP 


(deb address) 
{ (1-12) ] 


00 = A 
04- B 
08= E 
(SYS IN or 
SYSOUT) 


BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


BUILD 


(area address, 1 ( ( number of buffers! , ( buffer length \ \ 

\ d-12) n{ (2-12) ( J (2-12) a 




QSAM 


BUILDRCD 


(area addressi , J number of buffers! , \ buffer length! 
j (2-12) f ( (2-12) f ) (2-12) ( 

, ( record area address ! , j record area length 1 
j (2-12) ([] (2-12) (J 





4-2 OS/VS1 Programmer's Reference Digest 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Code 


QSAM 


BUILDRCD 
(list, form) 


area address, number of buffers, buffer length 
,record area address [, record area length],MF = L 




BUILDRCD 

(execute 

form) 


[area address | , [number of buffers]], [buffer length} 
L (2-12) J 

, [record area address 1 , [record area length] 
L I 2 " 12 ) J 

,MF = (E, /control program list address)) 
I (1) / 




BDAM 
BISAM 
BPAM 
BSAM 


CHECK 


/decbaddress\[",DSORG=/IS \\ 
\ (1-12) /[_ lALL/J 




BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


CHKPT 


Idcb address[,checkid address Hcheckid length]] 1 

(cancel ' j 


(^Success- 
ful comple- 
tion 

04 = Restart 
occurred 
(^Unsuc- 
cessful com- 
pletion: 

Macro error 
(^Unsuc- 
cessful com- 
pletion: 

I/O error 
1 (^Success- 
ful comple- 
tion: 

Possible 

error 

14=Chkpt 
not taken 


CHKPT 
(list form) 


[deb address], [checkid address], checkid length 

L'S' J 

,MF = L 




CHKPT 

(execute 

form) 


[deb address], [checkid address], checkid length 

L's- J 

,MF = (E, /control program list address)) 
t (1) / 





Section 4: Data Management 4-3 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Codes 


BDAM 


CLOSE 


(deb address [" 


"REREAD"] [7 


DISP= I PASS H 


...) 




BISAM 






LEAVE 


\ DELETE f 






BPAM 






REWIND 


<KEEP > 






BSAM* 




"" 


) CATLG \ 






QISAM 






(uncatlg) 






QSAM 




[,TYPE = T]* 




CLOSE 


([deb address 


V, RE READ" 


[7DISP= i PASS )" 
\ DELETE / 
{ KEEP } 


,...) 






(list form) 




, LEAVE 












, REWIND 












j CATLG I 

f uncatlg) 










[,TYPE = T]*,MF = L 




CLOSE 


[([deb address 


f, REREAD" 


[7DIS?= I PASS j" 
\ DELETE / 
< KEEP } 


,...)] 






(execute 




, LEAVE 








form) 




, REWIND 












j CATLG \ 
f UNCATLG J 




















[, TYPE = T]*,MF = (E, (data management list address)) 
I (1-12) > 












BSAM 


CNTRL 


deb address, 


ss, 1 




Not avail- 


QSAM 






sp 'lil 

SK,j through 1 




able to user 
program 






< BSM 


> 










FSM 












BSR[, number of blocks] 
FSR[, number of blocks] 






















ESPt 












LMKt 












DMKt 












DSG 












ENG 










v y 





tSee OS/VS IBM 3886 Optical Character Reader Model 1 Reference, GC21-5069 



4-4 OS/VS 1 Programmer's Reference Digest 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Codes 


BDAM 


DCB 


The DCB macro is too complex to properly document 




BISAM 




in this publication. For information about this macro, 




BPAM 




please refer to OS/VS Data Management Macro 




BSAM 




Instructions, GC26-3793. 




QISAM 








QSAM 








BDAM 
BISAM 
BPAM 


DCBD 


fbSORG = (f[BS][, DA][, IS][, LR][, PO][, PS][, QS]"| j| 








BSAM 




[,DEVD = ( [DAXPCJCPR^PT^RDJ^TAJ^MR] [ /0 r])] 




QISAM 






QSAM 








QISAM 


ESETL 


/deb address) 
\ (1-12) / 










BSAM 


FEOV 


/deb address) [,/REWIND)"] 
I (1-12) /LlLEAVE /J 




QSAM 






BPAM 


FIND 


/deb address! , f (name address ) , D ) 
t (1-12) / \{ (2-12) \ 


00 = A 






04 = B 






H (0) J \ 


08 = C 






\ (relative address list) ,C / 


Note: 






n (2 ~ 12) ( 


relcdr, C 






[l (0) ) J 


always 
returns 
CC of 00 


BDAM 


FREEBUF 


/deb address) , register* 
t (1-12) / 




BISAM 






BPAM 




*Note: Reg, any of 2 to 12, 




BSAM 




contains addr of buffer. 




BDAM 


FREEDBUF 


(decb address) ,/K) ,/dcb address) 
\ (2-12) MD/ t (1-12) / 




BISAM 










I (0) > 




BDAM 


FREEPOOL 


/deb address ) 

t d-12) ; 




BISAM 






BPAM 








BSAM 








QISAM 








QSAM 








QISAM 


GET 


(deb address ) 


", (area address)"! 




QSAM 




<pdab address? 
( (1-12) ) 


^ (2-12) > [,TYPE=P] 





Section 4: Data Management 4-5 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Codes 


BDAM 
BISAM 
BPAM 
BSAM 


GET3UF 


/deb address\ , register* 
X (1-12) 1 

*Note: Reg, any of 2 to 12, is where the system will 
place the buffer address. 




BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


GETPOOL 


/deb address) , (/number of buffers! ,/ buffer length)] 
I (1-12) / <\ (2-12) ) I (2-12) f> 




BPAM 
BSAM 


NOTE 


/deb address) 

t o-i2) ; 




BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


OPEN 


(/deb address) , [(options)], .. .) 
t (2-12) / 




BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


OPEN 
(list form) 


( [deb address] , [(options)] ,...), MF = L 




OPEN 

(execute 

form) 


[([/deb address)"] , [(options)] ,...)]' 
Q (2-12) f] 

,MF = (E,/data management list address)) 
I (2-12) / 


Open Macro Options 


ACCESS 
METHOD 


DEVICE TYPE 


MAGNETIC TAPE 


DIRECT ACCESS 


OTHER TYPES 


QSAM 


Option 1 Option 2 


Option 1 Option 2 


Option 1 Option 2 




"INPUT "1 1~, REREAD"] 
OUTPUT , LEAVE 

_rdbackJLdisp J 




"input ~| 

OUTPUT 
_UPDAT J 


, REREAD 

, LEAVE 

_,DISP _ 


[input 1 

[.OUTPUT J _ 


BSAM 




INPUT 
OUTPUT 
INOUT 
OUTIN 
_RDBACK_ 


[~, REREAD"] 

, LEAVE 
L/DISP J 




INPUT 

OUTPUT 

INOUT 

. OUTIN 

_UPDAT 


T, REREAD" 
, LEAVE 
,DISP 


[input 1 

L OUTPUT J" 


QISAM 
(Load Mode) 


— — 


[OUTPUT] 


— — 


BPAM, 
BDAM 


— — 




"input ~| 

OUTPUT 
UPDAT J 


— — 


Optionally select one from vertical stack within [ ] 



4-6 OS/VS1 Programmer's Reference Digest 



Data Management Macros (cont'd) 



Completio 
Codes 



MAXDCB =dcb n 



!dcb address /, \block address / 
(1-12) ■, (2-12) ( 

I (0) ) 



BSAM 
QSAM 



I deb address ( , *9 I , joverflow exit address ( 
) (2-12) \ |12) L I (2-12) | 



j deb addre 



, ^orea addre 
', (2-12) 
/ (0) 



QISAM 
QSAM 



\ deb address / 
I d-12) ( 



, \input deb address / 

1 (2-12) , 

. ' (0) ). 



|R I 



,\ deb address/ , \area address/ 



\ ( 



(2-12) 



, (length ), i key address I, (block addresser, (next address |1 
■](2-12)^ ) (2-12) ( j (2-12) [[ j (2-12) }J 



/ 



\ 



BDAM 
data set 



SF, / deb address \ , ( area address ) 
\ (2-12) / I (2-12) f 



( deb addre: 
I (2-12) 



e (2-12r S \ 



( length) 
(2-12) 



j key address | 
) (2-12) \ 



BPAM 
BSAM 



READ 
(list form) 



( RBLtj 



j deb addre; 
I (2-12) 



(- length 
(2-12) 



decb name, type*, r deb address "I , f area address") , f length"] 

[ 's 1 J L 's- J L "s- J 

, T key address "1 , [block address] , [next address] , MF=L 

*Note: type will be one of the parameters (e.g., K,SF, 
Dl) from the applicable standard form of the READ macro. 

+ See OS/VS IBM 38B6 Optical Character Reader Model 1 
Reference , GC21-5069 



Section 4: Data Management 4-7 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 




READ 


fdecb address), type*,rdcb address"], ("area addresser length"] 
\ (2-12) / L (2-12) J (2-12) L 'S' J 

Tkey addressIT block address - ], ["next address "1, MF=E 
(2-12) L (2-12) J L (2-12) J 

♦Note: type will be one of the parameters (e.g., K, SF, Dl) 
from the applicable standard form of the READ macro. 




BDAM 


RELEX 


D, /deb address), (block address) 

\ (1-12) / { (2-12) > 

* (0) ) 


00 = A 
04 = B 
C8 = D 


QISAM 
QSAM 


RELSE 


I deb address) 
\ 0-12) / 




QISAM 


SETL 


/deb address) , ' K[H] , , lower limit address i \ 

\ (1-12) f KC \, 2-12 I 

KD[H] » , (0) l| 

KCD ) ( 1 

ID V 1 

B 

\bd ; 




BSAM 
QSAM 


SETPRT 




fdeb oddressl 
l (2-12) / 

/ p,FroLD] "I ^ 

,UCS--(csc ,F[OLDj,V[ERIFY] ) 
L»V[ERIFY] J 

[,FCB = (image-idr,v[ERIFY]l)]r,OPTCD = /3)l 

[_,a[lign]J L iu/J 

!,FCB = (ima S e-idr,vrERIFY]l)[,OPTCD = (/B)r,F[OLD] ])] 
[,A[LIGN]J \u/[,U[NFOLD]J 

,OPTCD-=((B)[",F[OLD] 1) 
V llj/[,U[NFOLD]j ) 


> 




SETPRT Completion Codes 

FCB UCS FCB/UCS 

Bits 16-23 Bits 24-31 Bits 24-31 

00 00 Successful completion 18 NOP: incorr 
04 04 Operator cancellation 

08 08 Permanent I/O error previoJs^l/O 

in image library 

20 Insufficient s 
0C 0C Permanent I/O error fof imagEL 

during load 

10 10 Permanent I/O error 24 Unable to op 
during image display SYS1.IMAG 

14 14 Operator cancellation: 
incorrect image 


ect 

attempt 
3 blocks 
ELI3 



4-8 OS/VS1 Programmer's Reference Digest 



Data Management P\/lacros (cont'd) 








A./M 


Mac* 


Pcrometers 


Completion 
Codes 


a SAM 
QSAM 


SETPPJ 
(list form) 


" deb address 

r,F[OLD] "I ^| 
,UCS = (csc ,F[OLD],V[ERIFY] ) 
L,V[ERIFY] J 

[ # FCB = (imoge-idr / VrERIFY]l)]r,OPTCD = |Bl1 

,FCB = (:mQge-idr / V[ERIFY]])[,OPTCD = aB\rF[OLD] 1)] 
[_,AL'-IGN]J lU/[,U[NFOLD]J 

/ OPTCD = (/B\r,F[OLD] 1) 

_V \u/[,uCnfold]J 

,MF = L 


> 






3 SAM 

QSAM 


SEIPRT 
(execute 


I (2-12) / 










/ r,F[OLD] "I >| 
,UCS = (csc ,F[OLD],V[ERIFY]) 

[_,,v[erify] J 

[,FCB = (;m ag e-;dr,V[ERIFY]"|)] r,OPTCD=|B)"| 

,FCB = (imogc-idrv[ERIFYjJ)t,OPTCD = aB\r,FrOLD] J])] 
L,A[LIGN]J lU/[,U[NFOLDjJ 

,OPTC0-(/Bir,F[OLD] 1) 

\ Wl,u[nfold]J 


• 










,MF = (E,/data management list address) ) 
X (1-12) f 





Section 4: Data Management 4-9 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Codes 


BPAM 


STOW 


/deb address) , ( list address \ 
\ (1-12) / ) (2-12) } 


Ia a i ~ 














)c ( 














. 1 (0) i 


)?\ 
































Code 
(hex) 


Directory Action 










A | R | D 




C 


























Successful 














00 


completion 
















Name already in 






Newn 


ame already 










04 


directory 


— 


~ 


in dire 


ctory 








Name not 


Old na 


me not 








08 


~ 


found 


found 






OC 


No space in directory 


No 
dire 


c?o" ^ 




Permanent I/O error 












10 


in directory 










Specified data con- 












14 


trol block not open 










Insufficient 












18 


virtual storage 








BDAM 


SYNADAF 


( / ACSMETH=BDAM > 




"l 00=A with 


BISAM 




HACSMETH=BPAM ( 




1 ! no msg 


BPAM 
BSAM 




klm^Zi^^-^''^^ 2 ^ 


m reg* 


1 ( 


04=A with 
msg. 


QISAM 




yACSMETH=BISAM - r « 
1 ACSMETH=EXCP ,PARM1 = /iobcddressl 

L t d-12) ; J 




/ 


08=B 


QSAM 






j 




EXCP 






I 








1 ACSMETH=QISAMI",PARM1 =jdcb addressyi[,PARM2-parm reg 1 


"1J 








*Note: Any of registers 1 to 12 












**Note: Any of registers or 2 through 12. 








BDAM 


SYNADRLS 








00=A 


BISAM 










08= E 


BPAM 












BSAM 












QISAM 












QSAM 












EXCP 













4-10 OS/VS1 Programmer's Reference Digest 



Data Management Macros (cont'd) 









Completion 


A/M 


Macro 


Parameters 


Codes 


QSAM 


TRUNC 


(deb address) 
t d-12) | 










BDAM 


WAIT 


[number of events,] /ECB = addr ) 
lECBLIST = addrj 




BISAM 






BPAM 
BSAM 




[•™ 6 -®] 




BSAM 


WRITE 


decb name, (SF \ A deb address), farea address) 
)SFr( t (2-12) / t (2-12) / 














SD 








'sz > 








r, length"] r, next address "1 
[,P;l2)j[.(2.|2) J 
















Meaning 






Fixed- Length 


Variable or Unspecified Length 




Code 


(SF or SD) 


(SF or SFR) 


(SZ) 


00 


Block written. (If previous return 


Capacity record 










code was 08, block written only 


written; another 










if the DD statement specifies 


track available. 










secondary space allocation and 












sufficient space available.) 




04 


Block written, fol- 


Block not 












lowed by capacity 


written; 












record . 


write a 
capacity 
record (SZ) 
to complete 
current track, 
then reissue. 




08 


Block written, 




Capacity record was 










followed by capac- 




written. 










ity record. Next 




Next block requires 










block requires 




secondary space al- 










secondary space 




location. This code 










allocation. 




not issued if WRITE 
SZ is only WRITE 
macro instruction 
issued on a one- 
track secondary 
extent. 








OC 


Block will not be written; issue a CHECK macro instruc- 
tion for the previous WRITE macro, then reissue the 
WRITE. 


BDAM 


WRITE 


decb name,/ DA \, i'dcb address) , (area address) 
DAF \ (2-12) / \ (2-12) \ 
Dl ' S ' ) 




















) DIF \ V J 








1 D,X ( 








1 DK I 








1 DKF I 








VdkxJ 








, (length \, (key address\ ,/block address) 
{ 'S' H (2-12) I \ (2-12) / 














w, 'l. T ) 




BISAM 


WRITE 


decb name, ( K ) , fdeb address) , (area address) 
IKN/ I (2-12) / < (2-12) > 














, ( length), (key address) 
|(2-12)> I (2-12) j 











Section 4: Data Management 4-11 



Data Management Macros (cont'd) 



A/M 


Macro 


Parameters 


Completion 
Codes 


BPAM 
BSAM 


WRITE 


decb name, SF, (deb address! ,S area address) [, Hength ) 1 
\ (2-12) / \ (2-12) /[ 1(2-12) / J 






WRITE 
(list 
form) 


decb name/ type*, [deb address 1 ,|"area address"] 

I -s' J 

, riength"], Tkey address"], [block address] , [next addressl , 

L -s' J L -s 1 J 

MF =L *Note: type will be one of the keyword 
parameters (e.g., SF, DA, K) 
from the applicable standard form 
of the WRITE macro. 






WRITE 

cute 
form) 


( decb address), type*,["dcb address*], ["area address"] 
I (2-12) / L (2-12) J (2-12) 

, Tlength "],rkey address"], ("block address"] , ["next address"], 
(2-12) (2-12) L (2-12) J L (2-12) J 

MF=E 

*Note: type will be one of the keyword 
parameters (e.g., SF, DA, K) 
from the applicable standard 
form of the WRITE macro. 




BDAM 

BISAM 

BPAM 

BSAM 

QISAM 

QSAM 


XLATE 


/area address\,/ length \[,TO =/A\"] 
\ (2-12) M(2-12)R IE /J 





4-12 OS/VS1 Programmer's Reference Digest 



Direct Access Device Capacities 



Device 
Type 


Volume 
Type 


Maximum 
Blocksize/ 
Track 1 


Tracks/ 
Cylinder 


No. of 
Cylinders 2 


Total 
Capacity 1 , 2 


2314/ 
2319 


Disk 


7294 


20 


200 


29,176,000 


3330/ 
3333 
(Model 1) 


Disk 


13030 


19 


404 


100,018,280 


3330/ 
3333 
(Model 11) 


Disk 


13030 


19 


808 


200,036,560 


3340 


Disk 


8368 


12 


696(70-megabyres) 
348(35-megabytes) 


69,889,536 
34,944,768 


2305-1 


Drum 


14136 


8 


48 


5,428,224 


2305-2 


Drum 


14660 


8 


96 


11,258,880 



1- Capacity indicated in bytes (when R0 is used by the IBM programming 
system). 

2- Excluding alternate cylinders. 



Device 
Type 


Blocks with keys 


Blocks without keys 


Bi 


Bn 


Bi 


Bn 


2314/ 
2319 


534 
146+jf|(KL+DL) 


45+KL+DL 


101+ff|(DL) 


DL 


3330/ 
3333 
(Model 1) 


191+KL+DL 


191+KL+DL 


135 + DL 


135 + DL 


3330/ 
3333 
(Model 1 1) 


191+KL+DL 


191+KL+DL 


135+DL 


135 + DL 


3340 


242+KL+DL 


242+DL+DL 


167+DL 


167+DL 


2305-1 


634 + KL+DL 


634 + KL+DL 


432 +DL 


432 + DL 


2305-2 


289 + KL+DL 


289 + KL+DL 


198 + DL 


198+DL 


Bi is any block but the last on the track 
Bn is the last block on the track 
KL is the key length 
DL is the data length 



Section 4: Data Management 4-13 



Volume Organization with IBM Standard Labels 



Single Data Set 
Single Volume 



HDR1 



UHL1 



Data 
Set 



EOF! 



EOF2 



UTL1 



TM 



Single Data Set 
Multiple Vo lumes 



EOV1 



EOV2 



EOF1 



EOF2 



Label 




1 Data Set 



Trailer Labels 




End of 
Data Set 



Single Data Set/Single Volume: The volume label is followed by the data 
set header labels and optional user header labels. The data set is preceded 
and followed by a tapemark. The data set trailer labels are identified as 
EOF and followed by optional user trailer labels. Two tapemarks follow the 
trailer label group to indicate that the data set is the last data set on the 
volume and is not continued on another .olume. 

Single Data Set/Multiple Volumes : More than one volume is needed to contain 
the data set. The last volume is organized the same as a single volume. On 
the other volumes, the data set trailer labels are identified as EOV instead of 
EOF, and the trailer label group is followed by one tapemark instead of two. 
The data set and user labels are repeated on each volume, and there is a 
separate volume label for each tape. 



4-14 OS/VS1 Programmer's Reference Digest 



Volume Organization with IBM Standard Labels (cont'd) 

Multiple Data Sets 



Multiple Data Sets 
Single Volume 




Vol 1 of 3 




Multiple Volumes 
Vol 2 of 3 


Vol 3 of 3 •« 


von 






VOL1 




VOL! 




VOL1 


HDR1 


HDR1 


HDR1 


HDR1 


HDR2 


HDR2 


HDR2 


HDR2 


UHL1 


UHL1 


UHL1 


UHL1 


U~ -J 


^-J 


I <— -— J 


^ 


UHLn 


UHLn 


UHLn 


UHLn 


TM ^ 


TM 


TM 


TM 


Data Set A 


Data Set A 






TasToF " — 
Data Set B 








TM 


TM 


TM 


EOF1 


EOF1 


EOF1 


EOF2 


EOF2 


EOF2 


UTL1 


UTL1 


UTL1 


^ 






Data Set B 
Continued 




____^^ 


UTLn 


UTLn 








UTLn 


TM 


TM 


TM 


HDR1 


HDR1 


HDR1 


HDR2 


HDR2 


HDR2 


UHL1 


UHL1 


UHL1 


r — ' x — -i 




— -i 


UHLn 


UHLn 


UHLn 


TM 


TM 


TM 


Data^eTB^ 


Data Set B 


Data Set C 


TM 


TM 


TM 


TM 


EOF1 


EOV1 


EOV1 


EOF! 


EOF2 


EOV2 


EOV2 


EOF2 


UTL1 


UTL1 


UTL1 


UTL1 


^~J 




^ ~^_J 


r ^_ ^ 


UTLn 


UTLn 


UTLn 


UTLn 


TM 


TM 


TM 


TM 


TM 


k, — -J 




TM 


Multiple D 


ata Sets/Single Volume: The tape begins with a v 


olume label . 



Each data set is preceded by a header label group and a tapemark, and is 
followed by a tapemark and a trailer label group. The data set trailer labels 
are identified as EOF. Each trailer label group is followed by a tapemark; 
the toiler label group for the last data set on the volume is followed by 
two tapemarks. 

Multiple Data Sets/Multiple Volumes : More than one volume is needed 
to contain the multiple data set aggregate. The last volume is organized 
the same as a multiple data set/single volume layout. On the other 
volumes, the last data set trailer labels are identified as EOV instead of 
EOF, and the last trailer label group is followed by one tapemark instead 
of two. There is a separate volume label for each tape. 



Section 4: Data Management 4-15 



IBM Standard Label Processing by Data Management Routines 



Processing 


Volume 
Label 


Header Labels 1 


Trailer Labels 1 


VOL1 


HDR1 


HDR2 


UHL1-8 


EOF1 or 
EOV1 


EOF2 or 
EOV2 


UTL1-8 


First or Only 


Open 

Open 

Open 
or 

4 

user 


Open 

Open 
Open 


Open 

not 
read 

Open 


Open 

not 
read 

Open 


EOV 

not 
read 

Close 
or EOV 


bypassed 

not 
read 

Close 
or EOV 


EOV 

Open 5 

Close 
or EOV 


Volume: 2 


Checks labels 
on input 
tape. 

Checks exist- 
ing labels on 
output tape 
before over- 
writing. 

Writes new 
labels on out- 
put tape. 


Second or 


EOV 

EOV 

EOV or 
user 4 


EOV 

EOV 
EOV 


bypassed 

not 
read 

EOV 


EOV 

not 
read 

EOV 


EOV 

not 
read 

Close 
or EOV 


bypassed 

not 
read 

Close 
or EOV 


EOV 

not 
read 

Close 
or EOV 


Subsequent 


Volumes: 3 


Checks labels 
on input tape. 

Check labels 
on output tape 
before over- 
writing. 

Writes new 
labels on out- 
put tape. 


Notes: 

1 . For read backward operations, the action on header and trailer labels 
is reversed. 

2. Includes the first volume of concatenated data sets with unlike charac- 
teristics. Data sets with like characteristics can be processed correctly 
using the same data control block (DCB), input/output block (IOB), 
and channel program. Any exception in processing makes the data sets 
unlike. 

3. Includes the first volume of concatenated data sets with like charac- 
teristics. 

4. User can create the label with the IEHINITT utility program or a user 
program. Subsequently, the label may be rewritten by the Open and 
EOV routines. 

5. If DISP=MOD is specified on the DD statement, the Open routine posi- 
tions the tape at the end of the existing data set and allows an input user 
trailer label routine to process user trailer labels (prior to overwriting 
the existing labels). 



4-16 0S/VS1 Programmer's Reference Digest 



Format of IBM Standard Volume Label 

PosiMon . (Bytes) Field Number ond Name 



1 

3 


(3) 


4 


(1) 


5 






(6) 


10 




11 


(1) 


12 






(10) 


21 




22 






(10) 


31 




32 






(10) 


41 




42 






(10) 


51 




52 








80 


(29) 



1 . Label Identifi 



ier / 



2. Label Number 



3. Volume Serial Number* 



4. Reserved 



5. VTOC Pointer 

(Direct Access Only) 



6. Reserved 



7. Reserved 



* Functional Fields 



8. Owner Name and Address Code 



Section 4: Data Management 4-17 



Format of IBM Standard Data Set Label 1 

Position (Bytes) Field Number and Nai 



l 


(3) 




3 


4 


(1) 


5 


[ (17) J 








21 


22 


(6) 










27 


28 


(4) 






31 


32 


(4) 




-" 


'35 


36 


(4) 






39 


40 


(2) 


41 


42 


(6) 










47 


48 


(6) 










53 


54 


(1) 


55 


(6) 










60 


61 


(13) 








73 


74 


(7) 












80 



1 . Label Identifier 



HDR1/EOV1/EOF1* 



2 . Label Number 

3. Data Set Identifier* 

4. Data Set Serial Number 

5. Volume Sequence Number 

6. Data Set Sequence Number* 

7. Generation Number 

8. Version Number 

9. Creation Date 

10. Expiration Date* 

11. Data Set Security* 

12. Block Count* 

13. System Code 



* Functional Field 



4-18 OS/VS1 Programmer's Reference Digest 



Format of IBM Standard Data Set Label 2 

Position 1 (Bytes) Field Number end Name 



1 

3 


(3) 


4 


(1) 


5 


(1) 


6 
10 


(5) 


11 
15 


(5) 


16 


(1) 


17 


(1) 


18 
34 


(17) 


35 
36 


(2) 


37 


(1) 


38 


CD 


W 


(1) 


40 
80 


■(41) : 



1 . Label Identifier) 

VHDR2/EOV2/EOF2 ' 

2. Label Number ) 

3. Record Format 



4. Block Length * 



5. Record Length * 



6. Tape Density 

7. Data Set Position 



8. Job/ Job Step Identification 



9. Tape Recording Technique ' 

10. Control Character * 

1 1 . Reserved 

12. Block Attribute * 



13. Reserved 



Section 4: Data Management 4-19 



Format of User Label 

Position 



(Bytes) Field Number and Name 



1 

3 


(3) 


4 


0) 


5 
80 


: (76) : 



1. Label Identifier 

2. Label Number 



*} 



UHL1-8/UTL1-8 



3. User Specified 



* Functional Field 



4-20 OS/VS1 Programmer's Reference Digest 



Volume Organization with ANSI Standard Labels 



Single Data Set 
Single Volume 



VOL! 



HDR1 



HDR2 



UHL 



UHL 



Data 
Set 



TM 



EOF1 



EOF2 



UTL 



UTL 



TM 



Single Data Set 
Mult iple Volumes 



Label 

Data Set Header 
Labels 




Data Set Trailer 
Labels 



User Trailer Labels 



End of Data Set 



Single Data Set/Single Volume: The volume label is followed by the data 
set header labels and optional user header labels. The data set is preceded 
and followed by a tapemark. The data set trailer labels are identified as 
EOF and followed by optional user trailer labels. Two tapemarks follow 
the trailer label group to indicate that the data set is the last data set on 
the volume and is not continued on another volume. 

Single Data Set/Multiple Volumes : More than one volume is needed to 
contain the data set. The last volume is organized the same as a single 
volume. On the other volumes, the data set trailer labels are identified 
as EOV instead of EOF, and the trailer label group is followed by two 
tapemarks. The data set and user labels are repeated on each volume, 
and there is a separate volume label for each tape. 



Section 4: Data Management 4-21 



Volume Organization with ANSI Standard Labels (cont'd) 

Multiple Data Sets 



Multiple Data Sets 
Single Volume 




Vol 1 of 3 




Multiple Volumes 
Vol 2 of 3 


Vol 3 of 3 


VOL1 






VOL1 




VOL1 




VOLT 


HDR1 


HDR1 


HDR1 


HDR1 


HDR2 


HDR2 


HDR2 


HDR2 


UHL 


UHL 


UHL 


UHL 






Z^Z^l 


~~Z^~~Z 


UHL 


UHL 


UHL 


UHL 


TM 


TM 


TM 


TM 


Data Set A 


Data Set A_ 




Last of 

Data Set B_^ 


TM 


TM 


TM 


EOF1 


EOF1 


EOF1 


EOF2 


EOF2 


EOF2 


UTL 


UTL 


UTL 




^-— -\_ ^ 


Data Set B ~ 
Continued 


- 


UTL 


UTL 








UTL 


TM 


TM 


TM 


HDR1 


HDR1 


HDR1 


HDR2 


HDR2 


HDR2 


UHL 


UHL 


UHL 


^z^zz^i 


^Z^C^v 


r — — — * 


UHL 


UHL 


UHL 


TM 


TM 


TM 


Data Set B 


Data Set B 




Data Set C 








TM 


TM 


TM 


TM 


EOF1 


EOV1 


EOV1 


EOF1 


EOF2 


EOV2 


EOV2 


EOF2 


UTL 


UTL 


UTL 


UTL 


-~- 


~~— 




; , 




r ~*~A 




The tc 








UTL 


UTL 


UTL 


UTL 


TM 


TM 


TM 


TM 


TM 


TM 


TM 


TM 


Multiple Da 


ta Sets/Sin 


gle Volume: 


pe begins wit 


i a vc 


lume label . 



Each data set is preceded by a header label group and a tapemark, and is 
followed by a tapemark and a trailer label group. The data set trailer 
labels are identified as EOF. Each trailer label group is followed by 
a tapemark; the trailer label group for the last data set on the volume is 
followed by two tapemarks. 

Multiple Data Sets/Multiple Volumes : More than one volume is needed 
to contain the multiple data set aggregate. The last volume is organized 
the same as a multiple data set/single volume layout. On the other 
volumes, the last data set trailer labels are identified as EOV instead of 
EOF, and the last trailer label group is followed by two tapemarks. There 
is a separate volume label for each tape. 



4-22 OS/VS1 Programmer's Reference Digest 



ANSI Standard Label Processing by Data Management Routines 



Processing 


Volume Label 


Header Labels' 


Trailer Labels' 


VOL1 


USER 

VOLUME 

LABELS 


HDR1 


HDR2 


HDR3-9 


UHL 


EOF1 
EOV1 


EOF2 

or 

EOV2 


EOF3-9 

or 

EOV3-9 


UTL 


First or On 
Volume 2 : 

Checks 
labels on 
input tape. 

Checks 
existing 
tables on 
output 

tape before 
over- 
writing 

Writes new 
labels on 
output 
tape. 


y 

Open 
Open 

Open 
user 4 


Ignored 
Ignored 

not 
written 


Open 
Open 

Open 


Open 

not 
read 

Open 


Ignored 

not 
read 

not 
written 


Open 

not 
read 

Open 


EOV 

not 
read 

Close 

or 

EOV 


bypassed 

not 
read 

Close 
EOV 


ignored 

not 
read 

not 
written 


EOV 
Open 5 

Close 

or 

EOV 


Second or 
Subsequent 
Volumes 3 : 

Checks 
labels on 
input tape. 
Checks 

labels on 
output tape 
before over 
writing. 

Writes new 
labels on 
output 
tape. 


EOV 
EOV 

EOV or 
user* 


ignored 
ignored 

not 
written 


EOV 
EOV 

EOV 


bypassed 

not 
read 

EOV 


ignored 
read 

not 
written 


EOV 

not 
read 

EOV 


EOV 

not 
read 

Close 

or 

EOV 


bypassed 

not 
read 

Close 

or 

EOV 


ignored 

not 
read 

written 


EOV 

not 
read 

Close 

or 

EOV 


Notes: 

1. For read backward operations, the action on header and trailer labels is reversed. 

2. Includes the first volume of concatenated data sets with unlike characteristics. (Data sets 
with like characteristics can be processed correctly using the same data control block 
(DCB), input/output block (IOB), and channel program. Any exception in processing 
makes the data sets unlike.) 

3. Includes the first volume of concatenated data sets with like characteristics. 

4. User creates the label with the IEHINITT utility program or a user program. 

5. If DISP=MOD is specified on the DD statement, the Open routine positions the tape at 
the end of the existing data set and allows an input user trailer label routine to process 

user trailer label routine to process user trailer labels (before overwriting the existing labels)* 



Section 4: Data Management 4-23 



Format of ANSI Standard Volume Label 

Position , 



(Bytes ) Field Number and Name 

1. Label Identif 



1 

3 


(3) 


4 


(1) 


5 
10 


(6) 


11 


(D* 


12 
31 


(20) 


32 
37 


(6) 


38 
51 


(14)* 


52 
79 


(28)* : 


80 


(D* 



itifier / 



2. Label Number \ 

3. Volume Serial Number ** 

4. Accessibility ** 

5. Reserved 



6. Reserved 



7. Owner Identification 



*-ANSI Field Differs 
from Corresponding 
IBM Field 

* Functional Field 



* T 8. Reserved 



9. Label Standard Level ** 



4-24 OS/VS1 Programmer's Reference Digest 



Format of ANSI Header 1 and Trailer 1 Labels 

Position ] (Bytes) Field Number and Nome 



1 

~3~ 


(3) 


4 


(1) 


5 




rj 


(17)* I 


TT 




_22 






(5)* 


~T7 




_28 




If 


(4)* 


_32 


(4)* 


"35 




_36 


(4) 


"39 




40 
~~4V 


(2) 


42 




' 


(6) 


47 




48 







(6) 


"53" 




54 


(D* 


55 




= - 


(6) 


"60 




6L 






r 03) 


73" 




74 






(7) 


"80 





1 . Label Identifier) 

>HDRl/EOVl/EOFl ■■ 

2. Label Number \ 



4. Set Identifier 

5. File Section Number 

6. File Sequence Number ' 

7. Generation Number 

8. Version Number 

9. Creation Date 

10. Expiration Date ** 

11. Accessibility ** 

12. Block Count ** 



*-ANSI Field Differs . 
from Corresponding 
IBM Field 

** Functional Field 



Section 4: Data Management 4-25 



Format of ANSI Header 2 and Trailer 2 Labels 



Position- 



50 



53 



(Bytes ) Field Number and Name 

1 . Label Identifier) 



1 

3 


(3) 


4 


0) 


5 


(1) 


6 
10 


(5) 


11 
15 


(5) 


_V6 





(2)* 



(28) 



2. Label Number ' 

3. Record Format i 



4. Block Length 



5. Record Length ' 



J HDR2/EOV2/EOF2 < 



(35)* 6. Reserved for Operating System ** 



7. Buffer Offset ' 



*-ANSI Field Differs 
from Corresponding 
IBM Field 

** Functional Field 
8. Reserved for Operating System 



4-26 OS/VS1 Programmer's Reference Digest 



Format of ANSI User Labels 

Position 1 (Bytes) Field Number and Name 



J_ 
T 


(3) 


4 


(D 


_5_ 
80 


(76) 



1 . Label Identifier 



2. Label number 



'} 



UHL1-8/UTL1-8 



* Functional Field 



3. User Specified 



Section 4: Data Management 4-27 



Component Support of Label Processing Features 



Item 


Assembler 


Linkage 
Editor 


Sort/ 
Merge 


Utilities 


COBOL 


FORTRAN 


PL/1 


RPG 


ANSV2 


ANSV3 


ANSV4 


Uses Data Manage- 
ment Facilities for 

Label Processing 


Yes 


Yes 


Yes 


Yes. 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Supports Standard 
Labels (SL,AL) 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Supports Standard 
User Labels (SUL, 
AUL) 


No 


No 


Yes 


Yes 


SUL-Yes 
AUL-No 


SUL-Yes 
AUL-Yes 


SUL-Yes 
AUL-Yes 


No 


No 


No 


Supports Nonstand- 
ard Labels (NSL)l 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Supports Unlabeled 
Tape (NL) 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Supports Bypass 
Label Processing 
Option (BLP)2 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Supports Concaten- 
ated Data Sets 
with Unlike 
Attributes 


No 


Yes 


No 


No 


No 


No 


\ 
No 


No 


No 


No 


' NSL can be specified only when installation -written routines that write and process the nonstandard 

labels have been incorporated into the operating system. 
*lf the BLP option is not specified at system generation, its use defaults to NL. 



4-28 0S/VS1 Programmer's Reference Digest 



Data Set Record Formats 

Fixed -Length Records 

Block 



Block 



Blocked 
Records 



Record A 


Record B 


Record C 




Record D 


Record E 


Record F 



\\_OpHonal Control / 

\ Character-I Byte/ 
Block \ / Block 



Unblocked 
Records 



Record A 




Record B 




Record C 




Record D 



Fixed -Length Records for ASCII Topes 
Block 



Blocked 
Records 



Optional 

Block 

Prefix 


Record A 


Record B 


Record C 





Block 




• ' 




X 


Optional 

Block 

Prefix 


Record D 


Record E 


Record F 



Record . 
/\ 



yt Optional Control 

v Character-1 Byte 



Block 



Unblocked 
Records 



Optional 

Block 

Prefix 


Record A 




Optional 

Block 

Prefix 


Record B 




Optional 
Block ' 
Prefix 


Record C 




Optional 

Block 

Prefix 


Record D 



Section 4: Data Management 4-29 



Data Set Record Formats (cont'd) 

Nonjponned, Variable - Length Records 
BDW 



- 


00 


*-A 


Record B 


Record C 



LI— Reserved -2 Bytes / 
Block Length -2 Bytes / 



LL 




LL 


00 


Record D 


Record E 


Record F 




L— Reserved -2 Byti 
—Block Length -2 Byte 



Spanned Variable - Length Records 
BDW 



LL 


00 


Record D 



LL 




Last 

Segment 
of Logical 
Record A 


First 
Segment 
of Logical 
Record B 




LL 




Intermediate Segment 
of Logical Record B 


LL 




Last 

of Logical 
Record B 


First 
Segment 
of Logical 
Record C 




It 









-Optional Control Character 
- Reserved -1 Byte 
- Segment Control Code - 1 Byte 
•Segment Length -2 Bytes 



Segment 
Control 
Code 



Data Portion of Logical Record B 



U 1 

<— Reco 



Data Portioi 
of First 
Segment 



Data Portio 
of Last 
Segment 



Legend 

BDW=block descriptor word 
RDW = record descriptor word 
SDW = segment descriptor word 
LL = block length 
It =segment length 



Seam 



Optional Control Character 
Reserved -2 Bytes 
Record Length - 2 Bytes 

it Control Codes 



Binary Code Relative Position of Segment 

00 Complete logical record 

01 First segment of a multisegment record 

10 Last segment of a multisegment record 

1 1 Segment of a multisegment record other than the 
first or lost segment 



4-30 OS/VS1 Programmer's Reference Digest 



Data Set Record Formats (cont'd) 

Spanned Variable - Length Records for BDAM Data Sets 




-Optional Control Character 

- Reserved - 1 Byte 

- Segment Control Code - 1 Byte 

- Segment Length - 2 Bytes 



Data Portion of Logical Record A 



Logical Record 
(In User's Work 
Area) 



Block Length - 
2 Bytes 

Reserved - 
2 Bytes 

Note: Not All Segment a 

Legend 

BDW = block descriptor w> 
RDW = record descriptor word 
SDW = segment de;cript< 
LL = block length 
11 = segment length 







u 


| Data Portion ' Data Portion ] Data Portion 
cl of 1 of 1 of Last 
First Segment [ Intermediate Segment Segment 


J 




\[ 


t 

u Optional Control Character 

— Reserved - 2 Bytes 

— Record Length - 2 Bytes 



mbinations are Represented 
Segment Control Codes 
Binary Code 



Relative Position of Segment 
00 Complete logical record 

>rd 01 First segment of a multisegment record 

10 Last segment of a multisegment record 

1 1 Segment of a multisegment record other 
than the first or last segment 



Section 4: Data Management 4-31 



Data Set Record Formats (cont'd) 

Vorioble - Length Records for ASCII Topes 
Block 



Blocked 
Records 



/ 


X 




/■ X 


Optional 

Block 
Prefix 


Record A 


Record B 


Record C 




Optional 

Block 

Prefix 


Record D 


Record E 


Record F 



Ct-Opti. 
— Re«>r 



ional Control Character 
Reserved - 2 Bytes ' 
Record Length - 2 Bytes 

'' Block 



Unblocked 
Records 



Optional 

Block 

Prefix 



Optional 

Block 

Prefix 


Record D 



Optional 

Block 

Prefix 



Note: Block prefixes on output records must be 
4 bytes long. 



Undefined - Length Records 



RDW = record descriptor word 
Lt = segment length 



\\_ Optional Control / 
N Character-1 Byte ' 
Block \ Block / 



Record B 



Undefined - Length Records for ASCII Tapes 



Optidnal 

Block 

Prefix 


c 


Data 



Block 




Optional 

Block 

Prefix 


Record A 



- Optional Control 
Character-1 Byte 

Block 



Optional 

Block 

Prefix 



Optional 

Block 

Prefix 



4-32 0S/VS1 Programmer's Reference Digest 



VSAM Macros for Data Access 

ACB (Generate an Access-Method Control Block) 



[label] 


ACB 


[BUFND^ number] 

[,BUFNI= number] 

[,BUFSP= number] 

[,CATALOG={YES | NO}] 

[,DDNAME=*£/name ] 

[,EXLST= address] 

[,MACRF=([ADR][,CNV][,KEY] 
[,DIR][,SEQj[,SKP] 
[,IN][,OUT] 
[.{NUBIUBF}])] 

[,PASSWD= address] 

[,STRNO= number] 



CHECK (Suspend Processing) 



[[label] J CHECK 



CLOSE (Disconnect Program and Data) 



[label] 


CLOSE 


(address,...) 
[,TYPE=T] 



ENDREQ (Terminate a Request) 



{[label] |ENDREQ \KPL= address 



ERASE (Delete a Record) 



{[label] J ERASE 



EXLST (Generate an Exit List) 



[label] 



[EODADMaddress [,{A | N}][,L])] 
[JKNAD^address [,{A I N}][,L])] 
[,LERAD=(address [,{A i N}][,L])] 
[,SYNAD=(address[,{A | N}][,L])] 



GENCB (Generate an Access-Method Control Block) 



[label] 


GENCB 


BLK=ACB 

[,BUFND= number] 

[,BUFNI= number] 

[,BUFSP-~ number] 

[,CATALOG={YES|NO}] 

[,COPlES= number] 

[,DDN AME=ddname] 

[,EXLST= address] 

[.LENGTH = number] 

[,MACRF=([ADR][,CNV][,KEY] 
[,Dm][ t SEQ][,SKP] 
[,BN][,OUT] 
[,{NUB|UBF}])] 

[,PASSWD= address] 

[,STRNO= address] 

[,V/ABEA=address] 



GENCB (Generate an Exit list) 



[label] 


GENCB 


BLK=EXLST 
[,COPIES= number] 
[,EOD AD =(addrvss[,{ A | N}][,L])] 
[JTWAD^address [,{A | N}][,L])] 
[,LENGTH= number] 
[,LERAD=(address [,{A | N}][,L])] 
[,SYNAD=(adtfn?JJ [,{A I N}][,L])] 
[,WA9EA=: address] 



Section 4: Data Management 4-33 



VSAM Macros for Data Access (cont'd) 

GENCB (Generate a Request Parameter List) 



[label] 


GENCB 


[ACB= address] 

[,AREA= address] 

[,AREALEN= number] 

[,ARG= address] 

,BLK=RPL 

[,COPIES=num&?r] 

[,ECB= address] 

[,KEYLEN= number] 

[,LENGTH= number] 

[,MSGAREA= address ] 

[,MSGLEN= number] 

[,NXTRPL= address] 

[,OPTCD=([{ADR | CNV | KEY}] 
[.{DIRlSEjOJSKP}] 
[,{ASY | SYN}] 
[,{NSP|NUP|UPD}] 
[,{KEOjKGE}] 
[,{FKS|GEN}] 
[,{LOC|MVE}])] 

[,RECLEN= number] 

[,Y!ASEA=address] 



GET (Retrieve a Record) 



{[label] | GET 



MODCB (Modify an Access-Method Control Block) 



[label] 


MODCB 


ACB= address 

[,BUFND= number] 

[,BUFNI= number] 

[,BUFSP= number] 

[,CATALOG={YES | NO}] 

[,DDNAME=drf/wme] 

[,EXLST= address] 

[,MACRF= ([ADR][,CNV][,KEY] 
[,DIR][,SEQ][,SKP] 
[,IN][,OUT] 
[.{NUBIUBF}])] 

[,PASSWD= address] 

[,STRNO= number] 



MODCB (Modify an Exit List) 



[label] 


MODCB 


EXLST= address 

[,EODAD=(address [,{A I N}][,L])] 
[,JRNAD=(address [,{A | N}][,L])] 
[,LERAD=(address [,{A | N}][,L])] 
[,SYHAD=(address [,{A | N}][,L])] 



4-34 0S/VS1 Programmer's Reference Digest 



VSAM Macros for Data Access (cont'd) 

MODCD (Modify a Request Parameter List) 



[label] 


MODCB 


RPL= address 

[,ACB= address] 

[,AREA= address] 

[.AREALEN-* number] 

[,ARG= address] 

[,ECB= address] 

[,KEYLEN= number] 

[,MSGAREA= address] 

[,MSGLEN= number] 

[,NXTRPL=adtfrm] 

[,OPrCD=([{ADR | CNV | KEY}] 
[,{DIR | SEQ | SKP}] 
[,{ASY | SYN}] 
[,{NSP|NUP|UPD}] 
[.{KEQJKGE}] 
f,{FKS | GEN}] 
[,{LOC|MVE}]) 

[,RECLEN= number] 



OPEN (Connect Program and Data) 



[ label] OPEN 



J (address [,(options)]...) 



POINT (Position for Access) 



[[label] POINT 



PUT (Store a Record) 



{[label] PUT 



RPL (Generate a Request Parameter List) 



[label] 


RPL 


ACB= address 

[,AREA= address] 

[,AREALEN= number] 

[,ARG= address] 

[,ECB= address] 

[,KEYLEN= number] 

[,MSG AREA= address] 

[,MSGLEN= number] 

[,NXTRPL= address] 

[,OPTCD=([{ADR | CNV | KEY}] 
[,{DIR | SEQ | SKP}] 
[,{ASY | SYN}] 
[,{NSP|NUP|UPD}] 
[,{KEQ | KGE}] 
[,{FKS | GEN}] 
[,{LOC|MVE}])] 

[,RECLEN= number] 



SHOWCB (Display Fields of an Access-Method Control Block) 



[label] 


SHOWCB 


ACB= address 

,AREA= address 

,LFNGTH= number 

[,OBJECT= {DATA | INDEX}] 

.FIELDS =([,ACBLEN][,AVSPAC][,BUFND] 
[,BUFNI][,BUFNO][,BUFSP]. 
[,CINV][,DDNAME][,ENDRBA] 
[,ERROR]t,EXLST][,FS] 
[,KEYLEN][,LRECL][,NCIS] 
[,NDELR][,NEXCP][,NEXT] 
f,NINSR][,NIXL][,NLOGR] 
[,NRETR][,NSSS][,NUPDR] 
[,PASSWD][.RKP][,STMST] 
[.STRNO]) 



Section 4: Data Management 4-35 



VSAM Macros for Data Access (cont'd) 

SHOWCB (Display Fields of an Exit List) 



[label] 


SHOWCB 


AREA= address 

,EXLST= address 

,FIELDS=([EODAD][,EXLLEN][,JRNAD] 

[,LERAD][,SYNAD]) 
,LENGTH= number 



SHOWCB (Display Fields of a Request Parameter List) 



[label] 


SHOWCB 


AREA= address 

,FIELDS=([ACB][,AREA][,AREALEN] 

[,ARG][,ECB][,FDBK][,KEYLEN] 

[,MSGAREA][,MSGLEN] 

[,NXTRPL][,RBA][,RECLEN] 

,LENGTH= number 

,RPL= address 



TESTCB (Test a Field of 


an Access-Method Control Block) 


[label] 


TESTCB 


ACB= address 
[,EKEJ= address] 
[,OBJECT={DATA | INDEX}] 
,{ATRB=([ESDS][,KSDS][,REPL] 

[,SSWD][,WCK]) | 
CATALOG={YES|NO}| 

MACRF=([ADR][,CNV][,Dm][,IN][,KEY] 

[,NUB][,OUT]t,SEQ][,SKP][,UBFl) | 
OFLAGS=OPEN| 
ACBLEN= number | 
AVSPAC= number | 
BUFND= number | 
BUFNI= number \ 
BUFNO= number | 
BUFSP= number | 
CINV= number \ 
DDNAME=ddname | 
ENDRBA= number \ 
ERROR= number | 
EXLST= address | 
FS= number \ 
KEYLEN= number | 
LRECL= number \ 
NCIS= number] 
NDELR= number \ 
NEXCP= number | 
NEXT= number \ 
.MSSR= number \ 
NDCL=-> number \ 
NLOGR= number | 
NRETR= number | 
NSSS= number] 
NUPDR= number \ 
PASSWD= address \ 
RKP= number \ 
STMST= address | 
STRNO=n«m£)er} 



TESTCB (Test a Field of 


an Exit List) 


[label] 


TESTCB 


EXLST= address 

[,ERET= address] 

{EODAD={0 | ([address][,{A | N}][,L])} | 
JRNAD={0 1 ([address][,{/L 1 N}][,L])} | 
LERAD={0 1 ([address][,{A \ N}][,L])} | 
SYNAD={0 1 ([address][,{A 1 N}][,L])}} 
[,EXLLEN= number] 



4-36 0S/VS1 Programmer's Reference Digest 



VSAM Macros for Data Access (cont'd) 

TESTCB (Test a Field of a Request Parameter List) 



[label] 


TESTCB 


RPL= address 
[,ERET= address] 
{IO=COMPLETE | 
OPTCD=([ADR][,ASY][,CNV][,DIR] 

[,FKS][,GEN][,KEQ][,KEY][,KGE] 
[,LOC][,MVE][,NSP][,NUP][,SEQ] 
[,SKP][,SYN][,UPD]) | 

RBA= number \ 

KECLEH= number] 

RPLLEN= number \ 

ACB= address \ 

AREA= address \ 

AREALEN= number \ 

ARG= address \ 
ECB= address | 
FDBK= number | 
KEYLEN=n«m6er| 
MSGAREA= address \ 
MSGLEN= number | 
NXTRPL= address] 



Section 4: Data Management 4-37 



Flow of Control in QSAM 



f Processing Program ) 



GET,PUT,PUTX 



New Buffer 
Needed 



GET or PUT 
Routine 



Synchronizing and 
Error Processing 
Routine 



n 



User's SYNAD/EODAD 
Routine 



Track Overflow 
Asynchronous Error 
Processing Routine 



Appendages 



\ Channel Status / , 
~* \ Word r ~ A 



^POST (o) J 






Appendages 



Channel Program 



7 



SIO (b) 



Present Buffer 
Ready for 
Scheduling 



End -of -Block 
Routine 


EXCP 




I/O Supervisor 



Legend 

(a) Previous Channel Program 

(b) Next Channel Program 
Control 

Reference 



I/O Interruption 

I 



I/O Supervisor 



I/O Interruption 
Supervisor 



EXCP Supervisor 



4-38 OS/VS1 Programmer's Reference Digest 



Flow of Control in BSAM and in BPAM 

7=C 



READ, 
WRITE 



Processing Program 



)= 



READ or WRITE 
Routine 



End-of-Block 
Routine 



I/O Supervisor 



I/O Interruption 

1 



I/O Supervisor 



I/O Interruption 
Supervisor 



EXCP Supervisor 



CHECK Routine 



EOV Executor 



User's SYNAD/EODAD 
Routine 



Track Overflow 
Asynchronous Error 
Processing Routine 



-*._-J 



/ 



1 

1 I 

I 



Appendages 



LPSW 



Legend: 

(a) Previous Channel 
Program 

(b) Next Channel Program 

Control 

Reference 



\ Channel Status / 
"*\ Word / "" 



DECB 



POST (a) 



Appendages 



f 



SIO (b) 



-*\ Channel Program A- — - 



Section 4: Data Management 4-39 



SAM Open Executor Selector - Stage 1 

These diagrams show the access method condftions that cause different executors to be 
selected, loaded, and to receive control after loading. X represents a condition that 
must be satisfied for the executor marked in that column. No indicates that the con- 
dition must not be specified for the executor to be selected. A blank in the upper 
portion of the table indicates that either the condition is not required for selection 

or not examined at the time 



Access Method Options 


Selections 


Actual Data Set 


XXX 


X X 


X X 


XXX 


X 


Dummy Data Set 






X 






*, DATA, orSYSOUT 
specified or DD statement 










X 


3505 (OMR/ftCE) or 3525 








X 




3886 (OCR) 










X 


Direct Access Device 


X 


X 


X 


X 




Printer with UCS Feature 
(1403 or 3211) 




X 








Printer with forms control 
buffer (3211 or 2245) 




X 








Buffer Pool Required 


X 


X 




XXX 




User Totaling Specified 






X X 


X X 




Executors 






AV 






IGG019AV 


IGG0191A 


1A 1A 1A 


1A 1A 1A 


1A 1A 


1A 1A 1A 


1A 1A 


IGG0191B 


IB IB IB 


IB IB IB 


IB IB 


IB IB IB 


IB IB 


IGG0191C 






1C 






IGG0191I 


11 


11 




11 11 11 


11 


IGG0191N 


IN 


IN 


IN 


IN IN IN 


IN 


IGG0191T 




IT IT 








IGG0191U 




1U 








IGG0191V 




IV 








IGG0191Y 






1Y 1Y 


1Y 1Y 




IGG0193I 


31 


31 




31 31 31 




IGG0196A 


6A 6A 6A 


6A 6A 6A 


6A 6A 


6A 6A 6A 


6A 


IGG0196B 


6B 6B 6B 


6B 6B 6B 


6B 6B 


6B 6B 6B 


6B 


IGG0196R 










6R 


IGG0196I 


61 61 61 


61 61 61 


61 61 


61 61 61 


61 


IGG0197E 




7E 








IGG0197F 




7F 








IGG0197L 








7L 


7L 


IGG0197M 








7M 


7M 


IGG0197U 




7U 








IGG0199F 










9F 


IGG0199G 










9G 


IGG0199W 










9W 



4-40 OS/VS1 Programmer's Reference Digest 



SAM Open Executor Selector - Stage 2 



Access Method Optioi 



BSAM or 
QSAM 

Output 

Inout, Outin 

Update 

Unit Record or 

Magnetic Tape or 

Paper Tape 

Direct-Access Storogi 

Wrile-lood 

(Create BDAM) 

Simple Buffering 



XXX 

XXX 

X X 



Track Overflow 

Chained Scheduling 

Search Direct 

RPS Device 

3505 

3525 

OMRor 

RCEor 

Print only and 

Associated Files 

3890 



XXX 

No No No 



Executors 



IGG0191D 
IGG0I9IE 
IGG0191F 
IGG0191G 
IGG0I9IH 
IGG0I9IJ 
IGG0I91K 
IGG0191L 
IGG0191M 
IGG019IO 
IGG0191P 
IGG019IQ 
IGG0I9IR 
IGG019IS 
IGG019IW 
IGG019IX 
IGG0I91Z 
IGG019I23 
IGG0196J 
IGG0I96K 
IGG0196L 
IGG0I96P 
IGG0197N 
IGG0197P 
IGG0197Q 
IGG0I97V 
IGG0I99X 
IGG0199L 
IGG0199O 



l« 



e DD statement, no stoge 2 e 



Section 4: Data Management 4-41 



SAM Open Executor Selector - Stage 3 



Access Method Options 


Selection 


Paper Tape 
Update 

Chained Scheduling 
Exchange Buffering 
Track Overflow 
None of the preceding 
Input 

*, DATA, orSYSOUT 
specified on DD statement 

QSAM 

Variable-length 
Record Format 

Spanned Records 


X 
X 
X 


X 
X 
X 


X 
X 

X 

X X 


X 

X 
X X 

X 


Executors 


12 12 

13 

18 18 

19 
26 


10 

13 
14 

17 

19 
26 

90 


11 

15 
16 

91 

92 
93 


15 

19 
26 

8L 8L 

94 


IGG01910 
IGG01911 
IGG01912 
IGG01913 
IGG01914 
IGG01915 
IGG01916 
IGG01917 
IGG01918 
IGG01919 
IGG01926 
IGG0198L 
IGG01990 
IGG01991 
IGG01992 
IGG01993 
IGG01994 



4-42 OS/VS1 Programmer's Reference Digest 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 



JCL 5-2 

Operator Command Outlines 5-8 

RES Central Operator Commands 5-12 

RES Workstation Operator Command Outlines 5-14 

SMF 5-17 

CRJE Macros and Commands 5-18 



Source Publications 



Additional JCL reference information is contained in OS/VS1 JCL 
Reference, GC24-5099. 

Additional operator commands information can be found in 
Operator's Library: OS/VS1 Reference, GC38-01 10. 

Additional SMF information is contained in OS/VS System 
Management Facilities (SMF), GC3 5-0004. 

Additional RES information is contained in OS/VS1 RES Workstation 
User's Guide, GC28-6879. 

Additional CRJE information is contained in OS/MFT, OS/MVT, and 
OS/VS1 CRJE System Programmer's Guide, GC30-2016; OS/MFT, 
OS/MVT and OS/VS1 CRJE Terminal User's Guide, GC30-2014;and 
Operator's Library: OS/VS1 CRJE, GC38-0335; 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 



Comment - Delimiter - Null - PEND - PROC Statements 



// 



Operations 



//* 



Comment's coded in free form. If all comments cannot be included 
on one statement, they can be continued on consecutive comment 
statements. 



The Delimiter Statement 



A 



Operations 



/* or any 
two charac- 
ters de- 
fined by 
the DLM 
parameter. 



Comments coded in free form. If all comments cannot be included on 
one statement, they can be continued on consecutive comment 
statements. 



The Null Statement 



// 



Operations 



// 



Blanks. The null statement placed at the end of job control state- 
ments and data indicates that the job is to be put on the queue of 
jobs ready for processing. 



The PEND Statement 



//Name 


Operation 


Comment Field 


//name 

(up to 8 characters followed 

by one or more blanks) 


PEND 


Comments coded in free form. If all 
comments cannot be included on one 
statement, they can be continued on 
consecutive comment statements. 



The PROC Statement 



//Name 


Operation 


Operands 


//name 

(up to 8 characters followed 

by one or more blanks) 


PROC 


Symbolic parameters and their correspond- 
ing default values, separated by commas: 

symbolic parm = val, symbolic parm = val 

In a catalogued procedure, the operand 
field is not optional . 

In an in-stream procedure, the operand 
field is optional. 



5-2 OS/VS1 Programmer's Reference Digest 



Job Statement 



The JOB Statement 


//Name 


Operation 


Operands 


P/K 


Comments 


//jobname 


JOB 


([account number] [ additional accounting information, ...]) 


P 


Can be made manda- 
tory 






[programmer's name] 


P 


Can be made manda- 
tory 






[ado«pc>{™}] 


K 


Requests storage type 






[CLASS = jobclass] 


K 


Assigns A-Z, 0-9 






[COND=((code, operator), ...)] 


K 


Specifies a maximum 
of 8 tests 






[MPROFILE = 'profile string'] 


K 


For ISSP only 






[MSGCLASS =output class ] 


K 


Assigns A-Z, 0-9 






MSG LEVEL = ( 


m\ 




K 








[PROFILE ='profile string'] 


K. 


For ISSP only 






[PRTY=priority] 


K 


Assigns 0-13 






* D =fc c i 




K 


Restart definition 






(NR ) 












[REGION =value K] 


K 


Specifies amount of 
storage space 






RESTART = ( < stepname 1 [ , checkid ] ) 
' stepname .procstepname ) 




K 


For deferred restart 






PriMe- / ([minutes] [, seconds]))] 
L TIME -tl440 /J 


K 


Assigns job CPU 
time limit 






[™<HK>] 


K 


Holds a job in job 
queue, or scans JCL 
for syntax errors 


Legend: 




P Positional parameter. 

K Keyword parameter. 

( ) Choose one. 

[ ] Optional; if more than one line is enclosed, choose one or none. 





Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5 -3 



EXEC Statement 



The EXEC Statement 



//Ha 



Operation 



Operands 



P/K 



Comments 



//[stepname] 



EXEC 



/ /program name ) \ 

JPGM = < * .stepname .ddname >f 

J (*. stepname. procstepname, ddname) ( 

\ [PROC =]procedure name / 

[ACCT =(accounting information, . . .) "1 

ACCT,procstepname = (accounting information, . . .) J 

[ADDRSPC = CT 



COND=( 



(code, operator) 

(code, operator, stepname) [, 

, (code , operator, stepname . procstepname). 



Jl,J LONLYj 



COND. procstepname = ( 



"(code, operator) 
(code, operator, stepname) 
(code, operator, stepname . procstepname). 



[-••] 



[,]r EvEN i) 

1 IonlyJ 



|~PARM = value 1 

L PARM . procstepname = va lue J 



RD .procstepname - 
[REGION = valueK] 



TIME = /([minutes] [, seconds])) 
( 1440 / 



TIME. procstepname - ( (minutes, seconds)) 
A 1440 / 



Identifies program or 
cataloged procedure 



Accounting information 
for step 

Requests storage type 

Specifies a maximum 
of 8 tests, or 7 tests if 
EVEN or ONLY is 
coded 

Specifies a maximum 
of tests, or 7 tests if 
EVEN or ONLY is 
coded 



Parentheses or apos- 
trophes enclosing value 
may be required 



Restart definition 



Specifies amount of 
storage space 

Assigns step CPU 
time limit 



Legend: 

P Positional parameter. 

K Keyword parameter. 

( ) Choose one . 

[ ] Optional; if more than one line is enclosed, choose one or none. 



5-4 OS/VS1 Programmer's Reference Digest 



DD Statement 



The DD Statement 



//Nai 



Operation 



P/K 



//rddname 

procstepnami 
L ddname 



LdATA[,DLM=xx] J 
[DUMMY] 

[AFF =ddname] 



AMP = [/AMORG'] 

[,'BUFND=number l ] 
[/BUFNI=number'] 
[/BUFSP=number'] 
NCK 



/CROPS 



s 1 NRC 
JNRE' 

■(£.}] 



[, , STRNO=number'] 

[, 'SYNAD -modulename 1 

[/TRACE'] 

[COPIES =nnn] 

DCB = (list of attributes) 

/'ddname \ 

«-„ / ) * .ddname I 

DCB = (<* ,, } 

M * .stepname. ddname I 

V* .stepname.procstepname .ddname/ 
[ DDNAME =ddname] 

[DEST=userid] 



[,list of attributes]) 



DISP =( 



NEW 
OLD 
SHR 
MOD 



, DELETE 

,KEEP 

,PASS 

,CATLG 

,UNCATLG 





-i 


", DELETE 
,KEEP 
,CATLG 
,UNCATLG 


) 




J 



[DLM=delimiter] 



Defines data set in the 
input stream 

Bypass I/O operations 
on a data set (BSAM 
and QSAM) 

Requests channel 
separation 

Modifies the program 
processing VSAM clusters 
or components 



For use with the SYSOUT 
parameter 



Completes the data 
control block 



Postpones the definit 
of a data set 



Specifies remote destin- 
ation for SYSOUT data 



Assigns a status, disposi- 
tion, and conditional 
disposition to the data set, 
CATLG, NEW, and 
UNCATLG are invalid for 
VSAM components and 
clusters 

Assigns delimiter other 
than /* 
(continued next page) 



Legend: 

P Positional parameter. 

K Keyword parameter. 

( ) Choose one . 

[ ] Enclosing subparameter, indicates that subparameter is optional; if more than one line is enclosed, choose one or more. 

[ ] Enclosing entire parameter, indicates that parameter may be optional, depending on what type of data set you are defining . 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-5 



DD Statement (cont'd) 



The DD Statement (con't) 


//Name 


Operation 


Operands 


P/K 


Comments 


(continued from 




r 


dsname *\ ~ 




K 


Assigns a name to a new 


previous page) 






dsname(member name) 
dsname(generation number) 
dsname(area name) 








data set or to identify an 
existing data set. An 
unqualified name is 1-8 






/DSNAME\ = 
IDSN / * 


&&dsname 


► 






characters beginning 






&&dsname(member name) 






with an alphabetic or 








&&dsname(area name) 








national character. Area, 








* .ddname 








generation, member, and 








* .stepname .ddname 








temporary names are in- 








J* .stepname .procstepname .ddname y 








valid for VSAM clusters 










and components 






[--<— [:0r Y ]>] 


K 


Specifies forms control 
information. The FCB 
parameter is ignored if the 
data set is not written to 
a 321 1 printer 






["°H Y N E o s }] 


K 


Specifies whether JES 
writer processing of a 
SYSOUT data set is to be 
deferred or processed 
normally 








,SL 

,SUL 

,AL 


r, PASSWORD ir, IN 1 
,NOPWREAD L/OUTJ 














,AUL 












LABEL =([data set seq # ] 


,NSL 
,NL 
,BLP 
,LTM 


L J 




K 


Supplies label 
information 






L ' J 


r,EXPDT=yyddd"|v 












L,RETPD=nnnn J' 












[OUTLIM=number] 


K 


Limits the number of 
logical records you want 
included in the output 
data set 






[QNAME = process name] 


K 


Specifies the name of a 
TPROCESS macro which 
defines a destination 
queue for messages re- 
ceived by means of TCAM 






[SEP = (ddname, ...)] 


K 


Requests channel sepa- 
ration 

(continued next page) 


Legend: 




P Positional parameter. 




K Keyword parameter. 




( ) Choose one . 




[ ] Enclosing subparameter, indicates that subparameter is optional; if more than one line is enclosed, choose 


one or more . 


[ ] Enclosing entire parameter, indicates that parameter may be optional, depending on what type of data set 


you are defining . 



5-6 0S/VS1 Programmer's Reference Digest 



DD Statement (cont'd) 



The DD Statement (con't) 



//Na, 



Operation 



Operands 



P/K 



(continued from 
previous page) 



(TRK 
SPACE =(<CYL 



>, (primary r,secondary"|r, directory"!) 
(blocklength) I, JL, index J 



[: RLSE ] 



,CONTIG 

,MXIG 

,ALX 



[, ROUND]) 



SPACE =(ABSTR, (primary quantity, address!", directory"! )) 
_L L' index J / _ 

(n,CYL, (primary quantity [, secondary quantity])) 



'SPLIT = 



) (percent, block length, (primary [ , secondary ] )) 
\ percent 



(TRK ) 

1 SUBALLOC=(< CYL >, (primary!", secondary"]], directory |) 

(blocklength) [, J 

{, ddname \ 

, stepname .ddname > ) 

, stepname .procstepname .ddname / 

(classname \ 

(classname [*, program name"] [, form number])) 
L J 

PROFILE ='sysout profile string' 
(T, program namelT, form number"! 
,PROFILE='sysout profile string') 
[TERM=RT] 

PUCS -(character set codef,FOLD"| [, VERIFY])"] 



le[",FOLD"][, VERIFY])"] 





unit address 


,unit count 


UNIT = ( 


device type 


,P 




group name 


/ 


UNIT=A 


: T = ddname 





[,DEFER][,SEP -(ddname,...)]) 



|VOLUME) = (|PRIVATE]f, RETAIN"]f, volume seq# 



f",RETAIN"]r,v 



[, volume count] [, 



SER =(serial number, . . .) 

REF=dsname 

REF=* .ddname 

REF =* .stepname .ddname 

REF =* .stepname .procstepnai 



s .ddname 



Assigns space on a direct 
access volume for a new 
data set 



Assigns specific tracks on 
a direct access volume for 
a new data set 

Assigns space on a direct 
access volume for a new 
data set. Data sets share 
cylinders 

Requests part of the space 
on a direct access volume 
assigned earlier in the job 



Routes a data set through 
the output stream. For 
classname, assign A-Z 
or 0-9 



Indicates that an RTAM 
device is in use 

Requests a special char- 
acter set for a 1403 
printer 



Provides the system with 
unit information 



Provides the system with 
volume information. 
REF =dsname, 

* .step. ddname, and 

* .stepname .procstepname 
are invalid for VSAM 
components and clusters 



Legend: 

P Positional parameter. 

K Keyword parameter. 

( ) Choose one . 

[ ] Enclosing subparameter, indicates that subparameter is optional; if more than one line is enclosed, 

[ ] Enclosing entire parameter, indicates that parameter may be optional, depending on what type of 

1 Invalid for VSAM components and clusters 



, choose one or more . 
data set you are defining . 



Section 5 : JCL, Operator Commands, RES, SMF, and CRJE 5 -7 



Operator Command Outlines 



(CANCEL) 



= ] unitaddr* 
devicetype 
[procname^ 



', DUMP], ALL] 

■"[' 1 

L=holdJ 



identifier* 



,USER = useridl| 



* May be specified up to five times if separated by 
commas and enclosed in parentheses. Can be com- 
bined with the other parameters that are allowed 
to be specified up to five times. 



[LIST 1 

L PARM = membernamej 



.GRAPHIC 
JAPE 
DASD 



,ONLINE" 
., OFFLINE. 



[,cuu|[,nnn| 



,USER = userid] 
,ALL J 

(ALL[,L| 
RT )ACTUJ 
Kl )|NACT|,L] 

'TERM = termid[, device] 

,NW[ = qclass|l,USER = 
tQ/lLALLQ] 

jobname*[,HOLD] 

CONSOLES 



rid|) 



riN = class s 

)lN = , string[,string...]'[,ALL] ( 
)OUT = class t 

' OUT= 'stringl, string. . .] '[,ALL|) 



USER [:=userid] 



* May be specified up to five t 
and enclosed in parentheses. 



if separated by commas 



[text] 



(HALT) 



EOD 



m 



ALL 

MS f« 

OUT[ = outclass|; 

jobname*[,OUT[=outclass[outclass. . .]]][, USER = userid] J 

* May be specified up to five times if separated by 
commas and enclosed in parentheses. 



(LISTBC) 
I LB f 



[NOTICES|[,MAIL| = userid]] 
[MAILH=userid]|,NOTICES| 



{T} 



5-8 OS/VS1 Programmer's Reference Digest 



Operator Command Outlines (cont'd) 



userid l/password][TERM (termid)] 
[PROC (procname)] [NOTICES ] 

LnonoticesJ 

TAMIL ] 

[nomailJ 



' STATUS 
RETRY,(RECORD) 
IQUIET J 
MAIN, (RECORD) 
IQUIET / 
CONTROL,(THRESHOLD) | 
IQUIET // 

Note: Blanks may be u 
the commas in this comi 



and. 



(MODIFY) 



I (identifiei 

I [procname.] (Pnn 
( unitaddr 



' typrun ={nohold] 

,CLASS = outclass 
,CLASS = jobclass 

,START={ n ALL | 



ALL ) 



, RESTART = { ALL 



[, PAUSE = ( FORMS )] ([,JOBCLASS = jobclass]|,OUTCLASS = s|l 
L I DATASET/Jl[, OUTCLASS = s] J 



(MONITOR) 
t MN J 



JOBNAMES[,Tn 
DSNAME j 

SPACE \ 

, STATUS ( 

A \ 

■ SESS|,T] > 



(MOUNT) 



((NL,volserial)' 

unitaddr, VOL=aSL,volserial) 

((AL,volserial) 



(STORAGE 

,use = < public 
(private 



(MSGRT) 
I MR / 



/(D = (display-operand,...)[,MN=Al(,K)n 
IREF J 



(PAGETUNE) 



= [(][STOP] [)] 

[PAGEMEAS) 
[REACT] 
[STATUS] 



(PAGETUNE) 



Jlevel) , 



_ I frequency], In = frequency) . . ,)J 



/ frequency 
| (frequency) 
I SYS 
V(SYS)_ 

|(r^ L :]{(^ e e[,lpaget ro n]l); 
n ~J ((,pagetran) 



J(time[,[pagetra 
|(,pagetran) 
I SYS 
V(SYS) 



>> ,ln=4(time[,[pagetran]))i .. 
) L (Cpagetran) )J 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-9 



Operator Command Outlines (cont'd) 



Operation 


Operand 


m 


( (-ALL ) \ 
\)lN[ = inclass] f / 
) )Q [ = !ncloss] (l' JBN ( 
1 'oUT(=outclassi; j 

\ jobname *[,OUT[=outclass[outclass. . .]]][, USER = userid] J 

* May be specified up to five times if separated by commas 
and enclosed in parentheses. 


rn 


rrM . . /'text') 
t R l id <ttext } 


IT! 


. /PRTY = nn\[,OUT = s][,USER= userid] 
,obname*,-( CLASS = J 

* May be specified up to five times if separated by commas 
and enclosed in parentheses. 


/ROUTE) 
I RO J 


|-JBN = jobname][,GROUP=(class[,class...])] 

[all J 

[, USER= userid] [, CLASS = class] 
I, DEST = userid] r, HOLD =f YESJ1 


\T) 


[,ALL -If, NOW 1 

'text' ,USER= (userid], userid...] , LOGON 

L,OPERATOR = routecode J L, SAVE J 

l",UST ] 
message no. [ /DELETE J 


{?} 


DATE = yy.ddd[CLOCK = hh.mm.ss] 


{ STA RI} 




^procname {. identifier]^ L J 

, jobname 

, outclass 

, jobclass 

,(JOBCLASS = class,OUTCLASS = s) 

, (parm) 

,([mode = flNT )-|[,TIME = YES]l,DEBUG = YES][,BUF = nnn)) 

L ^ 

[,USER = userid] 

[, keyword = option, . . .1* 

* The keyword =optional parameter(s) can follow after the last 
positional parameter. May be replaced by: [,PARM= 'SWA = r 
RESV = nn'l. 




IT} 




| [procname]/. identifier *)[,USER = userid] J 
I l.Pnn / I 

j unitaddr* | 
/ jobname* \ 
j JOBNAMES | 
1 DSNAME 1 
1 SPACE 1 
V STATUS ) 

* May be specified up to five times if separated by commas 
and enclosed in parentheses. Can be combined with the 
other parameters that are allowed to be specified up to 
five times. 



5-10 OS/VS1 Programmer's Reference Digest 



Operator Command Outlines (cont'd) 



Operation 



Operand 



f JOBNAMES\ 
\ DSNAME / 
J SPACE \ 

) STATUS ( 

/a \ 

\ SESS J 



{T} 



Ion j 

V unitaddr, cuuJ 



(SWITCH) 



(UNLOAD) 



IT) 



Junitaddr 
((unitaddr, unitaddr. 



!, ONLINE 
, OFFLINE I 

,PATH,cuu,/ONLINE)| 
(OFFLINE), 



{ VA v RY } 



(unitaddr 
|(l-cuu,0-cui 



V,MSTCONS 



ra. 



/unitaddr) 
{sYSLOGl' HARDCPY 



,CMDS 

,NOCMDS 

,OFF 

,INCMDS 

,STCMDS 



(ALL 
ROUT=<NONE 



( (routecode [, routecode] . . . ), 



TO 



unitaddr \ r, unitaddr "| 

O-cuu U, O-cuu 

(l-cu^O-cuujJLd-cu^O-cuu)] 



(I 

f, ONLINE 
,OFFLINE 



,AUTH=^INFO } 

l([SYS][,IO][,CONS])) 
(ALL 
,ROUT = ^NONE 

( (routecode[, routecode]. 
unitaddr 
,ALTCONS = <JO- 

(l-cuu,0-cuu)) 



{unitaddr \ 

O-cuu 
(l-cuu,0-cuu)j 



(WRITELOG) 



{close} 



(WRITER\ 
I WTR J 



(job) 



[, JBN = jobnameJ[, USER = useridl 



I HOLD 

| REPEAT = f(nnn, JOB)) 
Innn )> 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-11 



RES Central Operator Commands 



Operator commands that require no 


modificat 


ion for RES. These commands are not 


valid from RES workstation. 








CONTROL 






SET 


DEFINE 






SWAP 


DUMP 






SWITCH 


HALT 






UNLOAD 


LOG 






VARY 


MODE 






WRITELOG 


Operator commands that use additic 




opera 


nds for RES. 


CANCEL 






REPLY 


DISPLAY 






RESET 


HOLD 






START* 


MODIFY 






STOP 


MONITOR 






STOPMN 


RELEASE 






WRITER 


*Command not valid from workstati 


on. 






New operator commands for RES. 








LISTBC 






ROUTE 


LOGON 






SEND 


LOGOFF 









5-12 OS/VS1 Programmer's Reference Digest 



Definitions of Substitutional Operands 



3 input (A-Z, 0-9) or output (A-Z, 0-9) class. 



; to fifteen job classes (A-Z, 0-9) without priorities. 



the channel and unit address (cuu) on an I/O device. 



symbolic remote device address used at RES workstation. 



devicetype 



lit type, such as 2540 or 1403, of the output device to be used. 



i four digit dec 



mber indicating on error count. 



frequency 



the number (0-9) of task dispatchings occurring before invocation of 
the page measurement routine. 



hour (00-23), minute (00-59), and s 






a two digit identifier that is identical to the identifier included in the 
system message. 



a unique one to eight character alphanumeric name that starts with a 
letter and identifies one task started by a cataloged procedure. 



? to four input que 



the channel and unit addresses (cuu) of the input (l-cuu) c 
(O-cuu) devices that make up a composite console. 



jobcla; 



one to fifteen job classes (A-Z, 0-9). Priority of processing is from 
left to right. 



jobname 



the name of a specific problem program that appears on the JOB 
statement. 



any valid keyword/option combination that may appear on a DD 
statement. 



e qu position (1-9 or N) on the STOP line. 



the in-i 



i single digit decimal n 



a one to three digit decimal number. 



i to eight output clas 



the channel and unit address (cuu) of an output only console. 



mber (0-255) of page transmission operations (page-ins and page-outs). 



information, of variable format, to be passed to a problem program 



□ partition number (P0O-P15). 



the name of a cataloged procedure that resides on SYS 1 .PROCLIB . 



qclass 



one to four queue classes (A-Z, 0-9 for input c 
output queue, HOLD for the hold queue). 



a system-to-operator message routing code. 



ingle output class (A-Z, 0-9). 



information of extremely v 



interval in seconds (0-9). 



mber indicating an hour limit. 



the channel and unit address (cuu) of an I/O device. 



al number of a disk pack o 



a recording mode: either R (re 



the year (00-99) and Julian day (000-366). 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-13 



RES Workstation Operator Command Outline 



Operation 


Operand 


iCANCELl 


([jBN=] jobname 1 (jobname, jobname, ...)([ ,DUMP][, ALL] )) 
) <,IN[ = class 1 HOLD] }( 
) (,OUT[=class 1 HOLD])? 
([DEV=] unitaddr 1 (unitaddr,unitaddr, . . .) ) 


(DISPLAY! 


1 jobnamel(jobname, jobname, ...)[, HOLD] f 
< Q[=li$t] > 
j N[=listl ( 

( USER tierid] ) 


m 


jobname 1 (jobname, jobname, . . .) 
TOUT r=outclass[outclass...] "1~| 
L |_=(outclass, outclass, . . .)JJ 


{ Ll ll° c } 


[NOTICES], MAIL]] 
[_MAIL[, NOTICES]] 


m 


'text' 


LOGOFF 




LOGON 


useridl/password] TERM (term-id) 
[PROC(procname)] 

[NOTICES 1 [mail I 

Lnonoiices] LnctmailJ 


/MODIFYJ 


(Iprocname.lid ) [,TYPRUN=HOLD 1 NOHOLD] 
< unitaddr > [,CLASS=classnames] 
(procname'.Pnn, 'data') [,PAUSE=FORMS I DATASET] 


/MONITOR! 
I MN ) 


JOBNAMES[,T] 


{RELEASE} 


jobname 1 (jobname, jobname, . . .) 
[,OUT [=outclass[outclass...] "]"| 
|_ l_=(outclass,outclass, . . .)J] 


m 


(BLANK) 

{/text 1 > 

ms 9 no Utext j 


{RESET} 


jobname 1 (jobname, jobname, . . .) [, PRTY=priority [,OUT=outclassJJ 
[,CLASS=class,OUT = outclass] 


(ROUTE\ 
t RO / 


(jBN=jobnamel,GROUP=list] ) 
<ALL[,GROUP=list] > 
(GROUP=list ) 

[,CLASS=outclass] l,DEST=userid] 
[,HOLD=YES INo] 


{SEND} 


'text' 


r f now ) i" 

, US ER=(userid[ , userid] . . .) ,< "LUGO N> 
LlSAVE jj 
_ ,OPERATORl=route-code] 





5-14 OS/VS1 Programmer's Reference Digest 



RES Workstation Operator Command Outline (cont'd) 



Operation 


Operand 


{ s T} 


procname[ .id] [,unitaddr] 

t,,jobname 1 ,, outclass] [,keyword=option, . . .] 


{ s n 


[identifier 1 (identifier, identifier, .. .)] 
[procname. identifier 1 (procname, identifier, . .)] 
[unitaddr 1 (unitaddr, unitaddr, . . .)] 

Specify at least one operand, or any combination up to 5. 


fSTOPMN) 


JOBNAMES 


/WRITER) 
\ WTR | 


(,HOLD } 

.. \,FSP=DSInnn / 

umt <,BSP=DS 1 JOB 1 nnn > 

V,REPEAT=nnn 1 (nnn, JOB) I 

(,LSP=nlC ; 

[,JBN=jobname] 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-15 



Definition of Substitutional Operands - RES 



class 


specifies an input or output class. • 


classnames 


1-8 output class names to be associated with the writer. 


data 


specifies information to be passed to the procedure. 


devicetype 


specifies a device type (for example, PR1). 


id 


specifies any unique one to eight character name that starts with 
a letter (except for Pnn or ALL). 


inclass 


specifies an input queue class. 


[obname 


specifies the name of a specific problem program. 


list 


specifies one to four queue classes. 


msgno 


one or two character identification of a message reply. 


" 


1, 2, 3 (single space, double space, or triple space). 


(n,...) 


specifies a single digit decimal number, or a list of numbers. 


nnn 


specifies a decimal digit from 1 to 255. 


nnn.aam 


nnn specifies a workstation (1-200), aa identifies a device type 
(RD, PR, PU), m identifies a particular device. 


nbs 


specifies a decimal digit from 1 to 100 (indicates the number of 
pages to be backspaced). 


nfs 


specifies a decimal digit from 1 to 255 (indicates the number of 
pages to be spaced forward) . 


outclass 


specifies an output class. 


password 


specifies an assigned sequence of one to eight alphameric 
characters. 


Pnn 


specifies the VS1 partition number in which the procedure was 
started. 


PP 


specifies numerical priority (decimal number from to 13). 


procname 


specifies the name of a cataloged procedure. 


rdr 


specifies the name of the reader procedure being started. 


route-code 


specifies a value which identifies a central console. 


term-id 


specifies a unique number (1-200) assigned to a remote terminal. 


text 


specifies information to be entered in response to a message. 


unit 


specifies the symbolic unit address (for example, PR1) of an I/O device. 


unitaddr 


specifies the channel and unit address (cuu) of an I/O device. 


userid 


specifies an assigned sequence of one to seven alphameric characters. 


wtr 


specifies the name of a writer procedure being started. 



5-16 OS/VS1 Programmer's Reference Digest 



SMF 

SMF 

SMFPRMxx parameters 

r en 

;v= /o 

) i 

) 2 



SI] 

so 



TEXT= 

JWT=nnn 
[BUF=nnnn] 

SID=xxxx 

TOPI= jYESj"! 

L )noU 

"MAN=f NONE) 
USER ( 
ALL \ 



1-collect system & job info 
2-collect system, job, & job step Info 

0-no data set or DASD info 
1-collect DASD info 
2-collect data set info 
3-collect data set & DASD info 

0-no temporary data set info 
2-collect temporary data set info 

NO-no exits 
YES-take exits 

nnn-wait state time limit in minutes 
nnnn-buffer size in bytes (max is 8192) 

xxxx-system identification 

YES-operator allowed to modify parameters 
NO-operator not allowed to modify parameters 

NONE-no records to SMF data set 

USER-only user records to SMF data set (type 128-255) 

ALL-all record types to SMF data set 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-17 



CRJE Macros 






Name 


Macro 


Operands 


[name] 


CRJELINE 


DDLINE=ddname, DDSYSIN=ddname [",RLN= (integer (1 

L \ i il 






,LERB=/ integer! ,integer2 ,integer3 Lingeg 

L IL^ 1 ^ JL ^ JL * 

(l050,ADDR=chars) T (BCD )" 

,TYPE=^ 2740-1 > ,CODE= ^CORRES> 

(2741 ) [_ /eBCD )j 


"])] 






CFEATURE^DIAL] ,[|NTERRUPT])] 






[.ONWT-j^j] 



Name 


Operation 


Operands 


name 


CRJETABL 


JOB= integer, USERS= integer, SYSCRJE= character 

[,JOBEXIT=routine name] [,ONEXIT=routine name] [,OFFEXIT=routine 

name] 

|",BUFNO= (integer^ |",MSGNO= (integer!! [",BRDCST=i integer)! 

L t JL 3 L t 122 (JL t 122 jj 

f",OUTNO= ( integer)"] |",MSGRC= (integer)! 

[,AL!AS= (command name,alias, . . . )] [, USRMCMD=(command, . . . )] 
[, USRSCMD= (subcommand, . . . ) ] [,CMDEXIT=routine name] 
[",PLlLNO= jinregerl! f",FORTLNO= \ integer j! 



Name 


Macro 


Operands 


[name] 


CRJEUSER 


[userid, password, . . .] 



5-18 OS/ VS 1 Programmer's Reference Digest 



CRJE Terminal Command Formats 



CRJE Terminal Command Formats 



1. 


CANCEL 


fobname 
[HfERE] 1 


2. 


CONTINUE 


BtEGIN] 
. NfEXTl - 


3. 


DELETE 


dsname 



fNEWlfNyM ITS [CAN] 1 
4. EDIT dsname L OLD J LnONUMJ LNOS [CAN] J 



PL! [ (parameters)] ' 



FORT < G 
' H 
DSLIST 
CLIST 
DATA 
TEXT 



EXEC dsname L NOLMST] 



r L [1ST] 1 

L NOUIST] J 



LISTBC 

LISTDS dsname [SITATUS1] [H [ISTORYl] 

8. LISTLIB [StTATUSl] [H [ISTORYl] 

9. LOGOFF 



10. LOGON userid/password 

[A [CCT] (accounting information)] 
*M[SGID] 1 



LNOBCJ L 



NOMtSGID]. 



11. OUTPUT 

12. SEND 'text' 

13. STATUS 

14. SUBMIT 

15. TABSET 



jobname [SMSG] 



UtSERHuserid) 



"N[QW] "I 



LtOGON] 



OtPERATOR] (integer) 
[jobname] 

dsname . . . 



num. . 
OFF 



'IN [PUT] 
OUT [PUT] 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5 - 19 



Edit Subcommands 



EDIT 
1. 
2. 
3. 

4. 
5. 



SUBCOMMANDS 
linenum [A text] 
CA [NCEU jobname 

C [HANGE] linenum [linenum] 
A text! Atext2A[ A [LL] ] 
D [ELETE] [linenum [linenum] ] 
END 

[increment] 
R 



I [NPUT] 



f [[increment] [1 ]]] |~ P [ ROMPT ] 1 

I linenum L R JJ [ NOP IROMPUJ 



|" NUM "1 

LnonumJ 



7. L [1ST ] [linenum [linenum ] ] L NONUM 

i dsname) 

8. M[ERGE] I * ) [linenum linenum ] [linenum] 



REN 



[linenum r increment "I 
JO L 12 J J 
S [AVE ] [dsname] [K [EYl (keyjL kl n 
SC[AN] [linenum [linenum] |_OFFj 



12. SEND 'text' 



U [SER] (userid)fNjOWi "I 
_0 [PERATOR] (integer) 



SUB [MIT] 
TAB [SET] 



/ dsname I 

f num...] flN [PUT] 
OFF 



OUT [PUT] 



5-20 OS/VS1 Programmer's Reference Digest 



Terminal Commands and Functions 



SESSION MANAGEMENT COMMANDS 


Command 


Function 




LOGON 


To Identify th 


e user and initiate his session. 


LOGOFF 


To terminate 


3 session. 


DATA MANAGEMENT COMMANDS 


General 






Command 


Function 




DELETE 


To scratch an 
user's library 


VS data set or to remove a CRJE data set from the 


EDIT 


To initiate creating or updating operations. 


EDIT Subcommands 




Subcommand 


Abbreviation 


Function 


INPUT 


1 


To insert and/or replace lines in the active set. 


DELETE 
Implicit 
CHANGE 


D 
C 


To remove lines in the active data set. 
To enter or delete lines in the active data set. 
To replace character strings within lines of the 
active data set. 


MERGE 


M 


To combine another data set with the active 
data set or to copy lines from one place to 
another within the active data set. 


RENUMBER 


REN 


To reassign line numbers to the lines in the 
active data set. 


LIST 


L 


To display lines of the active data set. 


SCAN 


SC 


To request a syntax analysis of PL/1 or 
FORTRAN source language statements in the 
active data set. 


SAVE 


S 


To store the active data set in the user's 
library. 


END 




To terminate creating and updating operations 
and to delete the active data set. 


JOB PROCESSING COMMANDS 


Command 


Function 




SUBMIT 


To enter a job into the VS job input stream. (Can also be used 
as an EDIT subcommand; it can be abbreviated SUB when used 
as a subcommand.) 


OUTPUT 


To request CRJE SYSOUT output of a conversationally -submitted 
job. 


CONTINUE 


To resume output listing that was previously interrupted. 


CANCEL 


To remove a job from the CRJE system and to delete any 
CRJE SYSOUT output of that job. (Can be used as an EDIT sub- 
command; it may also be abbreviated CA when used as a sub- 
command.) 


STATUS INFORMATION COMMANDS 


Command 


Function 




LISTLIB 


To obtain the 
in the user's 1 


name and characteristics of every CRJE data set 
brary. 



Section 5: JCL, Operator Commands, RES, SMF, and CRJE 5-21 



Terminal Commands and Functions (cont'd) - CRJE Installation 
Variables 



STATUS INFORMATION COMMANDS (cont.) 

Command Function 

LISTDS To obtain information about a particular CRJE data set in the 

user's library. 

STATUS To obtain information about jobs the user has submitted. 

MESSAGE COMMANDS 

Command Function 

SEND To send a message to the central operator or to another terminal 

user. (Can also be an EDIT subcommand.) 

LISTBC To request the broadcast messages. 

TABSET COMMAND 

Command Function 

TABSET To indicate the tab settings at the terminal. This command 

affects all input and output and can be either a command or an 
EDIT subcommand. (Can only be abbreviated - TAB - as a sub- 
command.) 

EXEC COMMAND 

Command Function 

EXEC To execute a sequence of commands contained in a CRJE data 
set. 



CRJE INSTALLATION VARIABLES 

The following functions, restrictions, and assignments are determined by the 
central installation when the system is generated. 

ADDITIONAL COMMANDS AND SUBCOMMANDS 

The installation may add commands and subcommands to the system by providing 

the routines to process them. 

COMMAND ALIASES 

The installation may assign alternate verbs (aliases) for the CRJE commands and 
subcommands. Duplication of aliases is allowed between modes but not within 
the same mode; i.e., the same alias may be used for a command and a sub- 
command, but it cannot be used for two commands (if in command mode) nor for 
two subcommands (if in edit mode). Either the CRJE name or the installation alias 
is recognized when entered from a terminal. 

EXIT ROUTINES 

Routines may be provided by the installation to check the accounting information 
on LOGON commands, to check JCL'statements of jobs submitted for batch 
processing, and to obtain accounting information when a user logs off the system. 
An installation routine may reject a LOGON command and may terminate a job 
submission. 



5-22 OS/VS1 Programmer's Reference Digest 



CRJE Installation Variables (cont'd) 



SYNTAX CHECKERS 

The installation selects what syntax checkers, if any, are provided in the system 

and the kind of checking performed (i.e., level of checking or language level 

supported). 

NUMBER OF LINES PER SYNTAX SCAN 

The installation can impose a limit on the number of lines one statement can 

span and still be scanned as a complete statement by the syntax checker. 

USER ID/PASSWORD 

The installation assigns userids and passwords to authorized terminal users, 

CRJE SYSOUT CLASS 

The system output class used for remote job output to be returned to terminal 
users is assigned by the installation. 

NUMBER OF LINES PER OUTPUT GROUP 

The installation specifies how many lines of output are sent to terminal before 
allowing the terminal user to interrupt the output. This only applies to terminals 
without a special interrupt feature. 

MAXIMUM NUMBER OF JOBS 

The maximum number of jobs that can reside in the central system at one time is 
determined by the installation. When this maximum is reached, no more jobs 
are accepted until some of the existing jobs are cancelled or their output is 
returned. 

MAXIMUM NUMBER OF MESSAGES 

The installation determines the number of messages that can be maintained by the 
system at any one time. This includes messages waiting for delivery at logon 
time and messages currently being processed. 

ROUTING CODES FOR MULTIPLE CONSOLES 

If the central system supports multiple consoles, the installation specifies a 
routing code for each console. A user may direct a message to an operator at a 
particular console by specifying the routing code for that console. 

ON-LINE TERMINAL TEST 

The installation determines whether or not the BTAM On-Line Terminal Test 
facility is provided. This facility provides tests that can be used by the terminal 
user as a start-up procedure or by the customer engineer for terminal checkout 
and diagnosis of terminal failure. 



Section 5 : JCL, Operator Commands, RES, SMF, and CRJE 5 -23 



System Operator Commands for CRJE 



Operation Operand 



BRDCST 



I nnnn/text' 
C Vtext' 
J nnnn 
( DELETE 



Operation Operand 



CENOUT C, J=jobname, C= class 



Operation 


Operands 


j MODIFY I 


[ procname . ] identifier, ( D ) = (address, . . . ) 



Operation 


Operand 


MSG 


C)M='text' [,U=user?d[,Q] I 
/D=userid J 



Operation 



Operands 



SHOW 



''JOBS [,|obname] 

USERS [,userid] 
| ACTIVE [, NUMBER] ( 

BRDCST 
| MSGS [,userid ] 

LERB [,lineaddress] 

SESS [,userid] 
I^SESSREL [,userid] 



Operation 



Operands 



{ s T} 



procname. identifier,,, ((FORM >|,ABNO ) ) 

^nfmt >),norm( 
(none) 1 ; 



Operation 



Operand 



{*?} 



[procname,] identifier 



Operation 



Operands 



USERID 



C, 



,A (DD] I =?- (user id, password) 

b (ELETE] » 

S[UPPRESS] 

R.[ESUME] 



5-24 OS/VS1 Programmer's Reference Digest 



Section 6: Linkage Editor and Loader 



Linkage Editor 

JCL Statements 6-2 

Execute Statement 6-3 

SIZE and REGION Parameter Guidelines 6-4 

Incompatible Job Step Options 6-5 

Return Codes 6-5 

Control Statement Outlines 6-6 

Record Formats 6-7 

Capacities 6-7 



Loader 

JCL Statements 6-8 

Execute Statement 6-9 

DD Statement Considerations 6-10 

Macro Outlines 6-10 

Macro Parameters 6-1 1 

Return Codes 6-12 

Virtual Storage Requirements 6-13 



Source Publication 

Detailed information about the linkage editor and loader is contained 
in OS/VS Linkage Editor and Loader, GC26-38 1 3. 



Section 6: Linkage Editor and Loader 6-1 



Linkage Editor JCL Statements - Optional/Required 

Required and Optional Statements 



Optional 


//jobname JOB 




See notes. 


//stepname EXEC/ PBM=HEWL \ 
t PGM=LINKEDITJ 


These names can also be 




used: IEWL 




, PA RM=' opt ions' 


IEWLF440 

IEWLF880 

IEWLF128 
or as a subprogram: 

LOAD/CALL 

LINK 

XCTL 
or as a subtask: 

ATTACH 




//SYSLIN DD dataset reference 


Primary input data sat: 
*-for an immediately 

following data set. 
DSNAME=dataset. 

DISP=(OLD, 

DELETE) for a 

cataloged data set 


opt. 


//SYSLIB DD dataset reference 


For automatic call: 
DSNAME= library, 
DISP=SHR 
libraries are; 
SYS1.ALGLIB 
SYS1.COBLIB 
SYS1.FORTLIB 
SYS1.PL1UB 
SYS1.SORTLIB 




// DD DDNAME=SYSIN 


Reference to linkage 
editor control statements 
if not included with 
SYSLIN data 




//SYSUT1 DD dataset reference 


Intermediate data set 




//SYSPRINT DD dataset reference 


Diagnostic output data 
set 




//SYSLMOD DD dataset reference 


Output module library 


opt. 


//SYSTERM DD dataset reference 


Required only if PARM= 
TERM specified on EXEC 
statement 




//ddname DD dataset reference 


One for each INCLUDE 
or LIBRARY reference 


opt. 


//Linkage Editor Control Statements 


In addition to or if not 
defined as a data set by 
the //SYSLIN DD state- 
ment 


opt. 


//Object Module (s) 


In addition to or if not 
defined as a data set by 
the //SYSLIN DD state- 
ment 




/* 


End of linkage editor 
input and job step. 




// 


End of job 



6-2 OS/VS1 Programmer's Reference Digest 



Linkage Editor Execute Statement 



Execute Statement: 
PARM='options' 
options are: 

AC(1) - assign an authorization code 

NE - not editable; no ESD produced in load module. NE is ignored 

if MAP or XREF specified. 

OL - only load; a LOAD and branch instruction or CALL required 

to load and enter module. 

OVLY - overlay; must be present if OVERLAY or INSERT statements 

are used. Not for use with refreshable, re-enterable, or 

serially reusable programs. 
RENT - re-enterable; all CSECTs must be re-enterable or RENT is 

ignored. 
REUS - reusable; all CSECTs must be re-enterable or serially reusable 

or REUS is ignored. 

REFR - refreshable; all CSECTs must be refreshable or REFR is ignored. 

XCAL - exclusive call; must be specified with OVLY. 

LET - allow execution; execution of the module may be attempted 

even if severity 2 errors have occurred during linkage editing. 
NCAL - no automatic library call; library members are not called to 

resolve external references. A SYSLIB DD statement need not 

be supplied. 
ALIGN2 - align on page boundary; used with PAGE or ORDER with P 

operand statements to cause alignment of CSECTs on 2K page 

boundary. Default is 4K alignment. 
SIZE= - size; value] is virtual storage available for linkage editor with 

(value], minimum of 65,536 and default of 196,608. Value2 is load 

value2) - module buffer with minimum of 6144, maximum of 102,400, 

and default of 65,536. 

DCBS - allow specification of DCB for SYSLMOD - block size must be 

specified in DCB parameter of SYSLMOD DD statement. 

LIST - list linkage editor control statements; statements appear in 

card-image format on diagnostic output data set. 

MAP - map the output module; the map appears on the diagnostic out- 

put data set. 

XREF - produce cross reference table; cross reference table, including 

map, appear on diagnostic output data set. MAP need not 
be used with XREF. 

TERM - print diagnostics on data set specified by SYSTERM DD 

statement; if SYSTERM DD statement is not included, TERM 
is ignored. 



Section 6: Linkage Editor and Loader 6-3 



Execute Statement (cont'd) - SIZE and REGION Parameter Guidelines 



PARM default attributes for the linkage editor: 




not tested 
block format 
not refreshable 
not re-enterable 
not serially reusable 




Execute Statement: 




REGION parameter 




REGION=value - if SIZE= was specified in PARM, partitio 
be 10K larger than value.. 


n size must 



SIZE AND REGION PARAMETER GUIDELINES 

Guidelines for determining an appropriate REGION parameter value and SIZE 
parameter values for a linkage editor job step: 

First - determine Value^ of the SIZE parameter. 

Value 



6K 
6144 



s [::*:] s 



where: a is the length of the load module to be built 
b is 0, if the length of the load module to be 
|~40K 
[40960 | 

T4K 1 
l_4096J 

I-40K 1 
[ 40960 J 

c is an integer C. 2 

d is the track capacity of the SYSLMOD device 
e is the block size of the SYSLMOD data set 
J is the length of the largest text record in load 

module input 
i is the track capacity of the SYSUT1 device 



built is < | ^ "| or 

if the length of the load module to 
be built 



Second - determine Value, of the SIZE parameter 



. must range between f and 



|~999K "1 
[999999 J 



where: f is the design point of the Linkage Editor being used: 



J64K ] 
[ 65536 J 

is the excess of Value- 

= Value -\ 6K 1 
Va,Ue 2 [6144 J 



.[6K 1 
L 6144 J 



h is the additional storage required to support the blocking 
factor for SYSLIN, any object module libraries, and SYSPRINT: 



[18K ] 
|_ 18432 J 



T28K "I 
[ 28672J 



Third - determine the REGION parameter. 
REGION = Value 



10K 1 
10240 J 



6-4 OS/VS1 Programmer's Reference Digest 



Linkage Editor Incompatible Job Steps - Return Codes 




Incompatible Job Step Options for the Linkage Editor 



Linkage Editor Return Codes 



Return 
Code 


Severity 
Code 


Description 


00 





Normal conclusion. 


04 


1 


Warning messages have been listed, execution should be 
successful. For example, if the overlay option is specified 
and the overlay structure contains only one segment, a return 
code of 04 is issued. 


08 


2 


Error messages have been listed, execution may fail. The 
module is marked not executable unless the LET option is 
specified. For example, if the block size of a specified 
library data set cannot be handled by the linkage editor, a 
return code of 08 is issued. 


12 


3 


Severe errors have occurred, execution is impossible. For 
example, if an invalid entry point has been specified, a 
return code of 12 is issued. 


16 


4 


Terminal errors have occurred, the processing has terminated. 
For example, if the linkage editor cannot handle the blocking 
factor requested for SYSPRINT, a return code of 16 is issued. 



Section 6: Linkage Editor and Loader 6-5 



Linkage Editor Control Statements 



Operation 


Operand 


ALIAS 


\ symbol 1 
/ external name \ 


, symbol 

, external name 




CHANGE 


external symbol (newsymbol)[, external symbol (newsymbol), .. .] 


ENTRY 


external name 


EXPAND 


name (xxxx) [,name(xxxx)] . . . 


IDENTIFY 


csectnameCdataOl/CsectnameCdata')] . . . 


INCLUDE 


ddnameKmembernameLmembername] . , .)] 

[,ddname[(membername[,membername] ...)]..,] 


INSERT 


csectname[, csectname, . . .] 


LIBRARY 


1 ddname(membername[,membername]. ..) ) 

/ (externalreference[,externalreference] . . ,) \ , . . . 

/ *(externalreference[externalreference] . . .) \ 


NAME 


membername[(R)] 


ORDER 


I common area name / 

< \ UP)] 

/ csectname \ 


I common area name # 

, < \ l(P)l 
/ csectname \ 




OVERLAY 


symbol! (REGION)] 


PAGE 


I common area name J 
/ csectname \ 


i common area name I 
/csectname \ 




REPLACE 


i csectname- l[(csectname-2)] j 
/ entry name j 


SETCODE 


AC(1) 


SETSSI 


xxxxxxxx 



6-6 OS/VS1 Programmer's Reference Digest 





Linkage Editor Record Formats - Capacities 




The follow 


ng 


ecord formats are used with the linkage editor: 




F 


- 


The records are fixed length. 




FB 


- 


The records are fixed length, and blocked. 


1 


FBA 


- 


The records are fixed length, blocked, and contain ANSI 
control characters. 




FBS 


- 


The records are fixed length, blocked, and written in standard 
blocks. 


1 


FA 


- 


The records are fixed length and contain ANSI control 
characters. 




FS 


~ 


The records are fixed length and written in standard blocks. 




U 


- 


The records are undefined length. 


1 


UA 


- 


The records are undefined length and contain ANSI control 
characters. 



Capacities 



Function 


Capacity 


Virtual storage allocated (in bytes) 


64 K 


Maximum number of entries in composite external symbol 
dictionary (CESD) 


558 


Maximum number of intermediate text records 


372 


Maximum number of relocation dictionary (RLD) records 


192 


Maximum number of segments per program 


255 


Maximum number of overlay regions per program 


4 


Maximum blocking factor for input object modules (number of 
80-column card images per physical record) 


10 1 


Maximum blocking factor for SYSPRINT output (number of 121- 
character logical records per physical record) 


ioi 


Output text 
record length 
(in bytes) 


On IBM 2314, 2319 
Storage Facility 


3072 2 


On IBM 2305-2 Fixed Head 
Storage Facility 


3072 2 


On IBM 3330 or 3340 Disk Storage 
Facility 


3072 2 


From 74K to 9999K for valuei of the SIZE option, the blocking factor for input 
object modules and SYSPRINT output is 40. 
"Hhe maximum output text record length is achieved when value2 of the SIZE 
parameter is at least twice the record length size. For example, on a 3330, 
12288 byte records are written when value2 is at least 24576. 



Section 6: Linkage Editor and Loader 6-7 



Loader JCL Statements 



//name 


JOB 


parameters 


(optional) 


//name 


EXEC 


PGM=LOADER , PARM= (parameters) 


//SYSLIN 


DD 


parameters 




//SYSLIB 


DD 


parameters 


(optional) 


//SYS LOUT 


DD 


parameters 


(optional) 


//SYSTERM 


DD 


parameters 


(optional) 


// (optional DD statements and dara required for loaded program) 



Input Deck for the Loader — Basic Format 
Loader EXEC Statement 

The two loader names are: 

1. LOADER 

2. IEWLDRGO 



6-8 OS/VS1 Programmer's Reference Digest 



Loader Execute Statement 



MAP. The loader. produces a map of the loaded program that lists external names 
and their absolute storage addresses on the SYSLOUT data set. (If the 
SYSLOUT DD statement is not used in the input deck, this option is ig- 
nored.) 

NOMAP. A map is not produced. 

RES. An automatic search of the link pack area queue is to be made. This 
search is always made after processing the primary input (SYSLIN), and 
before searching the SYSLIB data set. When this option is specified, the 
CALL option is automatically set. 

NORES , No automatic search of the link pack area queue is to be made. 

CALL. An automatic search of the SYSLIB data set is to be made. (If the 

SYSLIB DD statement is not included in the input deck, this option is 
ignored.) 

NOCALL An automatic search of the SYSLIB data set will not be made. When 
or NCAL. this option is specified, the NORES option is automatically set. 

LET . The loader will try to execute the object program even though a severity 
2 error condition is found. (A severity 2 error condition is one that 
could make execution of the loaded program impossible.) 

NOLET. The loader will not try to execute the loaded program if a severity 2 
error condition is found. 

SIZE=size. Specifies the size, in-bytes, of dynamic virtual storage that can be 
used by the loader. 

EP=name. Specifies the external name to be assigned as the entry point of the 
loaded program. This parameter must be specified if the entry point 
of the loaded program is in an input load module. For FORTRAN, 
ALGOL, and PL/l, these entry points must be MAIN, IHIFSAIN, 
and IHENTRY, respectively. 

NAME=name. Specifies the name to be used to identify the loaded program to 
the system. If this parameter is not used, the loaded program 
will be named **GO. 

PRINT. Informational and diagnostic messages are produced on the SYSLOUT 
data set. 

NOPRINT. Informational and diagnostic messages are not produced on the 
SYSLOUT data set. SYSLOUT is not opened. 

TERM 

Numbered diagnostic messages are to be sent to the SYSTERM data set. The 
SYSTERM data set can be used to replace or supplement the SYSLOUT data set 
at any time. (If the SYSTERM DD statement is not included in the input deck, 
this option is ignored.) 

NOTERM 

Numbered diagnostic messages are not to be sent to the SYSTERM data set. 

Unless otherwise specified with the LOADER macro instruction during system 
generation, the default options are: NOMAP, RES, CALL, NOLET, SIZE=100K, 
and PRINT. The default options NAME=**GO and NOTERM cannot be changed 
during system generation. 



Section 6: Linkage Editor and Loader 6-9 



DD Statements • Loader Macro 



The following considerations apply to the DCB parameter of SYSLIN, SYSLIB, 
and SYS LOUT. 

• For better performance, BLKSIZE and BUFNO can be specified. 

• If BUFNO is omitted, BUFNO=2 is assumed. 

• Any value given to BUFNO is assumed for NCP (number of channel 
programs). 

• If RECFM=U is specified, BUFNO=2 is assumed, and BLKSIZE and 
LRECL are ignored. 

• RECFM=V is not accepted. 

• RECFM=FBSA is always assumed for SYS LOUT. 

• If RECFM is omitted, RECFM=F is assumed for SYSLIN and SYSLIB. 

• If BLKSIZE is omitted, the value given to LRECL is assumed. 

• LRECL=121 is assumed for SYSLOUT. 

• If LRECL is omitted, LRECL=80 is assumed for SYSLIN and SYSLIB. 

• If OPTCD=C is used to specify chained scheduling, an additional 2K 
(2048 bytes) of virtual storage is needed in the user's region if the necessary 
data management routines are not resident. 

Note: The SYSTERM data set will always consist of unblocked 81-character 
records with BUFNO=2 and RECFM=FSA. Because these values are 
fixed, the DCB parameter need not be used. 

In addition to the DD statements used by the loader, any DD statements and 
data required by the loaded program must be included in the input deck. 



Loader Macro 



Name 


Operation 


Operand 


[symbol] 


/LINK \ 
(ATTACH/ 


EP=loadername 

PARAM=(optionlist [,ddname list] ) 
VL=1 


ra 


EP=loadername 



Macro Instruction Basic Format 



6-10 OS/VS 1 Programmer's Reference Digest 



Loader Macro Parameters 



EP 

specifies the symbolic name of the loader. The entry point at which execu- 
tion is to begin is determined by the control program from the library direc- 
tory entry. 

PARAM 

specifies, as a sublist, address parameters to be passed to the loader. The 
first fullword in the address parameter list contains the address of the option 
list for the loader and/or loaded program. The second fullword contains the 
address of the ddname list. If standard ddnames are to be used, this list may 
be omitted. 

option list 

specifies the address of a variable length list containing the loader and 

loaded program options. This address must be written even though no list is 
provided. 

The option list must begin on a halfword boundary. The two high-order 
bytes contain a count of the number of bytes in the remainder of the list. 
If no options are specified, the count must be zero. 

The option list is free form, with the loader and loaded program options 
separated by a slash (/ ), and with each option separated by a comma. No 
blanks or zeros should appear in the list. 

ddname list 

specifies the address of a variable length list containing alternative ddnames 
for the data sets used during loader processing. If the standard ddnames are 
used, this operand may be omitted. 

The format of the ddname list is identical to the format of the ddname list 
for invoking the linkage editor; the 8-byte entries in the list are as follows: 



Entry 


Alternate Name For 


1 


SYSLIN 


2 


not applicable 


3 


not applicable 


4 


SYSLIB 


5 


not applicable 


6 


SYS LOUT 


7-11 


not applicable 


12 


SYSTERM 



VL 



specifies that the sign bit is to be set to 1 in the last fullword of the address 
parameter list. 



Section 6: Linkage Editor and Loader 6-11 



Loader Return Codes 



Return 
Code 


Loader 
Return 
Code' 


Loaded 
Program 
Return 
Code 


Conclusion or Meaning 











Program loaded successfully, and execution of the 
loaded program was successful. 


4 





The loader found a condition that may cause an 
error during execution, but no error occurred during 
execution of the loaded program. 


8 (LET) 





4 





4 


Program loaded successfully, and an error occurred 
during execution of the loaded program. 


4 


4 


The loader found a condition that may cause an 
error during execution, and an error did occur during 
execution of the loaded program. 


8 (LET) 


4 


8 





8 


Program loaded successfully, and an error occurred 
during execution of the loaded program 


4 


8 


The loader found a condition that may cause an 
error during execution, and an error did occur during 
execution of the loaded program. 


8 (LET) 


8 


8 




The loader found a condition that could make exe- 
cution impossible. The loaded program was not 
executed. 


12 





12 


Program loaded successfully, and an error occurred 
during execution of the loaded program. 


4 


12 


The loader found a condition that may cause an 
error during execution, and an error did occur 
during execution of the loaded program. 


8(LET) 


12 


12 




The loader could not load the program successfully, 
execution impossible. 


16 





16 


Program loaded successfully, and the loaded pro- 
gram found a terminating error. 


4 


16 


The loader found a condition that may cause an 


8(LET) 


16 


error during execution, and a terminating error was 
found during execution of the loaded program. 


16 




The loader could not load program, execution 
impossible. 


'Error diagnostics (SYSLOUT and/or SYSTERM data set) for the loader will show 
' the severity of errors found by the loader. 



6-12 OS/VS 1 Programmer's Reference Digest 



Loader Virtual Storage Requirements 



Consideration 


Approximate 

Virtual Storage 

Requirements 

(in bytes) 


Comments 


Loader 
Code 


Control 


700 


- 


Processing 


13664 





Data Management 


6K 


BSAM 


Object Module Buffers 
and DECBs 


BUFNO(BLKSIZE+24) 


Concatenation of 
different BLKSIZE and 
BUFNO must be 
considered. (Minimum 
BUFN02) 


Load Module Buffer and 
DECBs. 


304 


— 


SYSTERM DCB 
Buffers, and DECBs 


312 


Allocated if TERM 
option is specified 


SYSLOUT Buffers 
and DECBs 


BUFNO(BLKSIZE + 24) 


Buffer size rounded up 
to integral number of 
double words. 
(Minimum BUFNO=2) 


Size of program being 
loaded 


Program Size 


Program size is 
restricted only by 
available virtual storage 


Each external relocation 
dictionary entry 


8 


— 


Each external symbol 


20 


- 


Largest ESD number 


4n 
n is the largest ESD 
number in any input 
module 


Allocated in increments 
of 32 entries 


Fixed Loader Table Size 


1260 


Subtract 88 if NOPRINT 
is specified 


System 
Requirements 


1600 


" 



Section 6: Linkage Editor and Loader 6-13 



6-14 0S/VS1 Programmer's Reference Digest 



Section 7: BTAM/TCAM 



BTAM 

Macros 7-2 

Macro Instruction Format 7-7 
2715 User-Table Macro Instructions 7-1 1 
Line and Station Configuration Supported by BTAM 7-13 
TCAM 

Macros 7-15 

Operator Commands 7-21 

Device Configurations Supported by TCAM 7-24 



Source Publications 

Detailed information about BTAM and TCAM is contained in these 
publications: 

• OS/ VS BTAM, GC27-6980 

• OS/VS TCAM Programmer's Guide, GC30-2044 



Section 7: BTAM/TCAM 7-1 



BTAM Macros 



Name 


Operation 


Operand 


[symbol] 


AS 


ID=absexp [, ASGROUP=symbol ] 
[ , DEGROUP=(symbol , absexp) ] 


[symbol] 


ASCTR 


ID=absexp, 
HIGHCTR=absexp, 

R0UTE '([{£s U J] 








[,log] 








[,ASLOG] \ 
[,EXTRALRM] / 














,NEXTAS=obsexp] 


[symbol ] 


ASLIST 


device-code , NORM=absexp 

[ r LENGTH=(absexpl.absexp2) ] 

[, DIGIT=(absexpl ,absexp2,absexp3)] 

[,ENTRY={^r} ][ f MSG='texf] 
[,INQDISP=absexp] 
[,MODULUS=(absexpl ,ab$exp2, 
obsex P 3)] . . 
[,SELTRAN={£g } ] 


(Omit) 


ASMTRTAB 


tablename, . . . 


[symbol ] 


CHGNTRY 


listaddr,listype,listposition, 
numchars, action 


[symbol ] 


/OPEN \ 
I CLOSE/ 


({deb,,}...), fMF=L I 
LMF=(E,listname)J 




[symbol ] 


CONFIGUR 


[«*-$}] [^}] 

,FUNCERR=(absexp,...)] 

,ENDERR=(absexp,...)] 

,MONERR=(absexp,...) ] 

,GETID=absexp] 

,STORID=absexp] 

,IDCOUNT=absexp] 

[..NQCSP-^}] 


[symbol ] 


CTRGROUP 


ctrno, 

[cttest], 

1 D=absexp 

[,SROENAB={NO|] 

(null ) 

[,CTINIT=<NCT \] 
(UNASP) 



> 2715 ONLY 



> 2715 ONLY 



7-2 0S/VS1 Programmer's Reference Digest 



BTAM Macros (cont'd) 



Name 


Operation 


Operand 


[symbol] 


CTRLIST 


DEVCOD=( B ) 










CTRADR= HMPl 
tEXPJ ' 






CTRRD= (SINGLE) 
I GROUP J ' 










CTTESTW NULL ) 






) SETNCT ( 






) SETUNAS ( ' 






( RESET ) 






CTROP^ READ \ 






\ SET f 






J READS ET \ 






) READRST ( 






/ RDRESID \ 






V NULL ; 






[,MSG='texf] 


[symbol] 


CTRSCHED 


sched, . . . 




DATAMGT 


ACSMETH=BTAM 


symbol 


DCB 


keyword operands 


[symbol] 


DEULIST 


[DIGIT=(absexp1,absexp2)] 
[,LENGTH=absexpl] 
[,MSG= , fext l ] 
,MODULUS=<absexpl,absexp2)] 
v DlGlT2=(absexpl,absexp2)] 


symbol 


DFTRMLST 


list type, 

device-dependent 

operands 


[symbol] 


DISPGUID 


DISPMSG='text' 
[,SU P PRES={£§}] 


[symbol ] 


GDUAS 


ID=absexp, 
GDUNUMB=absexp 


[symbol ] 


GDULIST 


PARAMNO=absexp 
[,(NORGUID=absexp,...)l 
f I DISPMSG=symboin 
L,l IDENT=absexp /J 










[,MSG='texf] 






[ f ENTRY={^}] 


[symbol ] 


GDUTRANS 


TRCODE=absexp, 
TRLIST=symboln 


[symbol ] 


IODEVICE 


UNIT=type, 

ADDRESS=address, 

ADAPTER=type, 

TCU=type, 

MODEL=model, 

. , FEATURED feature! , feature2, . . .) ] 

,SETADDR=rype] 

,OBRCNT=n ] 



> 2715 ONLY 



} 2715 ONLY 



Section 7: BTAM/TCAM 7-3 



BTAM Macros (cont'd) 



Name 


Operation 


Operand 


symbol 


LERB 


nlinesf, { ([transmct] 
[,datack], [,intreq] 
[,nontto]) } ....] 


[symbol] 


LERPRT 


dcbaddr[,rln][,cid] 

r,CLEAR=YES] 

L,CLEAR=NOJ 






[symbol] 


LOPEN 


decbaddr 


[symbol] 


ONLTST 


DECB=decb address, 
X=type of rest, 
Y=no. of transmissions, 
DCB=dcb address, 
AREA=rfr message area 
[,TEXT=user text area, 
LENGTH=user text length ] 
[,ENTRY=I 1st address] 
[,RLN=line number] 


[symbol] 


OPEN 


See CLOSE 


[symbol] 


PARAMNUM 


PLN=absexp, 
PARMLST=symboln 


[symbol] 


PARMLIST 


[ CKLNGTH=(length-absexp, 
errguidance-absexp, . . .) ] 

[,CKMONKY={^}] 

[ , CKMOD1 l=(length-absexp, 

position-absexp, 

errguidance-absexp, . . .) ] 

[ ,CKRANGE=(positionl-absexp, 

position2-absexp, 

hilowchars-absexp, . . .) ] 

[,LOWGUID=(absexp,...)] 

[,HIGUID=(absexp,...)] 

[ ,CKMOD10=(length-absexp, 

position-absexp, 

errguidance-absexp, . . .) ] 

[ ,CKOR=(position-absexp, 

checkcharl-hexchar, . . . 

checkcharn-hexchar) ] 

[,ORGUID=(absexp,...)] 

[ ,CKAND=(positionl-absexp, 

position2-absexp, 

checkcharl -hexchar, 

checkcharn-hexchar) ] 

[,ANDGUID=(absexp,...)] 

[ ,CKNONUM=(positionl-absexp, 

position2-absexp, 

errguidance-absexp, . . .) ] 

[ , CKNUM=(positionl -absexp, 

position2-absexp, 

errguidance-absexp, . . .) ] 

[. TRANSIT {$>}] 
[,IDENT={^}] 



> 2715 ONLY 



7-4 OS/VS1 Programmer's Reference Digest 



BTAM Macros (cont'd) 



: Name 


Operation 


Operand 


[symbol] 


/READ \ 
WRITE/ 


decbaddr,optype, dcbaddr, 

( [inoutarea] \ 
\([inarea] , [outarea]) ) , 

( [inoutlength] \ 
t([inlength],[outlength])J , 

[entry], [rln] |_,MF=eJ 


[symbol] 


RELBUF 


dcbaddr,bufferaddr 


[symbol] 


REQBUF 


dcbaddr, returnreg , [ count ] 


[symbol] 


RESETPL 


decbaddrrPOLLINGl 
L,ANSRINGj 


[symbol] 


RESETPL 


decbaddr[,AnENT] 


[symbol] 


STEND 




symbol 


TGROUP 


[TCn=(symboln [,E])] 


[name] 


TPEDIT 


MINLN=n[,REPLACE={|^l] 
[,BUFFER=|^- S )] 


[symbol] 


TRANSLAT 


TRANSChMiexcharJRANTXT^text' 


symbol 


TRUST 


TRID=absexpl 

[.rout* [{«?}]] 

iw [{&}] 

,INQDISP={£§}] 
,DEMOD10= {^5} 

,demodii={y^« 
[,gdi> {£§}] 


[symbol] 


TRNSLATE 


[dcbaddr], tablename, area, length 


symbol 


/TRSLRCTWl 
ITRSLRCT3 / 


Fx=code, . .. 


symbol 


(TRSLSCTW1 
ITRSLSCT3 J 


Xyy=Fx, . . . 


[symbol] 


TWAIT 


(returnreg), 
ECBLIST=ecb list addr 



\ LOCAL 3270 

/ ONLY 

1 2715 ONLY 

J 2715 ONLY 



IBM 50 

MAGNETIC 

DATA 

INSCRIBER 

ONLY 



> 2715 ONLY 



World Trade 

Telegraph 

Terminal 

World Trade 

Telegraph 

Terminal 



Section 7: BTAM/TCAM 7-5 



BTAM Macros (cont'd) 



Name 


Operation 


Operand 


[symbol] 


WAIT 


[count] 

ECB=ecb address, 
ECBLIST=ecb list addr 


[symbol] 


WRITE 


See READ 



7-6 OS/VS1 Programmer's Reference Digest 



BTAM Macro Instruction Format 





Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Register 


RX- 
type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 

Char 


Code* 




(2-12) 


(1) 


(0) 




ASMTRTAB 


tablename 
























x 


1 


CHGNTRY 


listaddr** 






X 








x 












1 


dcbaddr*** 






X 








X 














listype 
























X 




listposition 






X 










X 










1 


numchars** 






X 










X 












action 
























X 




CLOSE 


deb 














X 














MF= 
























X 




listname 






X 


X 




x 
















DCB 


DSORG= 
























X 




MACRF= 
























X 




DDNAME= 


X 


























BUFNO= 
















X 












BUFL= 
















X 












BUFCB= 














X 














EXLST= 














X 














BFTEK= 
























X 




LERB= 














• X 














EROPT= 
























X 




DEVD= 
























x 




MODE= 
























X 




CODE= 
























x 


1 


READYQ= 














X 










X 




DFTRMLST 


listype 
























X 




XX 






















X 






yy 






















x 






dialcount 




X 
























dialchars 




















X 








numsent 




X 
























sentchar 






















X 






numensent 




X 
























cntrlseq 






















X 






tidseq 






















X 






numrec 




X 
























ridseq 






















X 






AN 
























As 
Shown 




MD 
























As 
Shown 




AD 
























As 
Shown 



* See macro description for allowable vc 

* Does not apply to local 3270 display. 

* Applies only to local 3270 display. 



Section 7: BTAM/TCAM 7-7 



BTAM Macro Instruction Format (cont'd) 



Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Reg 


ister 


RX- 
Type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 
Char 


Code* 


(2-12) 


(1) 


(0) 


DFTRMLST 
(cont'd) 


entrylength 




X 






















userlength 




X 






















idcount 




X 






















idsent 






















x 




authsequence 






















X 




controlvalue 




X 






















userdata 














X 












LERB 


nlines 
















X 










transmct 
















X 










datack 
















X 










intreq 
















X 










notto 
















X 










LERPRT 


dcbaddr 


x 




x 


X 


















rln 






X 




X 






X 










cid 






X 








X 












CLEAR = 
























X 


LOPEN 


decbaddr 


X 




X 




















ONLTST 


DECB = 






X 


X 




X 














X = 






X 










X 










Y = 






X 










X 










DCB = 






X 






X 














AREA = 






X 






X 














TEXT = 






X 






X 














LENGTH = 






X 










X 










ENTRY = 






X 






X 














RLN = 






X 










x 










OPEN 


deb 














x 












MF = 
























X 


listname 






X 


X 




X 














READ 
(list form, 
MF=L) 


decbaddr 


X 
























optype 
























X 


dcbaddr 














X 












inoutarea 














X 












inarea 














x 












outarea 














X 












inoutlength 
















x 










inlength 
















X 










outlength 
















X 










entry 














X 












rln 
















X 










MF = L 
























As 

Shown 



* See macro description for allowable values. 



7-8 OS/VS1 Programmer's Reference Digest 



BTAM Macro Instruction Format (cont'd) 



Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Reg 


ister 


RX- 
Type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 
Char 


Code* 


(2-12) 


(1) 


(0) 


READ 
(Execute 
form, MF = E) 


decbaddr 






X 


X 




X 














optype 
























x 


dcbaddr 






X 






X 














inoutarea 






X 






X 












V 


inarea 






X 






X 












V 


outarea 






X 






X 














inoutlength 






X 










X 








V 


inlength 






X 










X 








V 


outlength 






X 










X 










entry 






X 






x 












V 


rln 






X 










X 










MF = E 
























As 
Shown 


READ 

(Standard 

form) 


decbaddr 


X 
























optype 
























x 


dcbaddr 






X 








X 












inoutarea 






X 








X 










's' 


inarea 






X 








X 










V 


outarea 






X 








X 












inoutlength 






X 










X 








V 


inlength 






X 










X 








V 


outlength 






X 










X 










entry 






X 








X 












rln 






X 










X 










RELBUF 


dcbaddr 






X 


X 




X 














bufferaddr 






X 




















REQBUF 


dcbaddr 






X 


X 




X 














returnreq 






x 




















count 






X 




X 






X 










RESETPL 


decbaddr 






X 


X 






X 












POLLING 
























As 
Shown 


ANSRING 
























As 
Shown 


ATTENT 
























As 
Shown 


TRNSLATE 


dcbaddr 






X 






X 














tablename 






X 






X 














area 






X 






X 














length 






X 




X 






X 








V 


TRSLRCTW 


Pnn = 
























X 


TRSLRCT3 


Pnn = 
























X 


TRSLSCTW 


Xyy = 
























X 


TRSLSCT3 


Xyy = 
























X 


TWA IT 


Returnreg 






X 




















ECBLIST = 






X 






X 














WAIT 


count 






X 




X 


X 




X 










ECB = 






X 


X 




X 














ECBLIST = 






x 


x 



















* See macro description for allowable values. 



Section 7: BTAM/TCAM 7-9 



BTAM Macro Instruction Format (cont'd) 



Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Reg 


ister 


RX- 
Type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 
Char 


Code* 


(2-12) 


0) 


(o) 


WRITE 
(List form, 
MF-L) 


decbaddr 


X 
























optype 
























X 


dcbaddr 














X 












inoutarea 














X 












inarea 














X 












outarea 














X 












inoutlength 
















X 










inlength 
















X 










outlength 
















X 










entry 














X 












rln 
















x 










MF = L 
























As 
Shown 


WRITE 
(Execute 
form, MF-E) 


decbaddr 






X 


X 




x 














optype 
























X 


dcbaddr 






X 






X 














inoutarea 






X 






X 














inarea 






X 






X 












V 


outarea 






X 






X 














inoutlength 






X 










X 








V 


inlength 






X 










X 








V 


outlength 






X 










X 










entry 






X 






X 














rln 






X 










X 










MF = E 
























As 
Shown 


WRITE 

(Standard 

form) 


decbaddr 


X 
























optype 
























X 


dcbaddr 


X 












X 












inoutarea 


X 












X 












inarea 


X 












X 










V 


outarea 


X 












X 












inoutlength 


X 














X 








V 


inlength 


X 














X 








V 


outlength 


X 














X 










entry 


X 












X 












rln 


x 














X 











* See macro description for allowable values. 



7-10 OS/VS1 Programmer's Reference Digest 



2715 User Table Macro Instructions 



Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Register 


RX- 
type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 
Char 


Code* 


(2-12) 


(1) 


(0) 


AS 


ID= 
















x 










ASGROUP= 


X 
























DEGROUP= 
tgroupname 
deunumber 


X 














X 










ASCTR 


ID= 
















x 










HIGHCTR= 
















X 










ROUTE= 
























X 


LOG 
























As 
Shown 


ASLOG 
























As 
Shown 


EXTALRM 
























As 
Shown 


NEXTAS= 
















X 










ASLIST 


device 
























X 


NORM= 
















X 










LENGTH= 
dita length 
gdlight2 
















I 










DIGIT= 
entry pos 
compvalue 
gdlight3 
















I 










ENTRY= 
























X 


MSG= 


















X 








INQDISP= 
















X 










MODULUS= 
entry pos 
fid length 
gdlight3 
















* 










SELTRAN= 
























X 


CONFIGUR 


CORE= 
























x 


PC= 
























x 


GDU= 
























X 


FUNCERR= 
















x 










ENDERR= 
















X 










MONERR= 
















X 










GETID= 
















X 










STORID= 
















x 










IDCOUNT= 
















X 










INQDISP= 
























x 



*See macro description for alio' 



Section 7: BTAM/TCAM 7-11 



2715 User Table Macro instructions (cont'd) 



Macro 
Instruction 


Operand 


Sym 


Dec 
Dig 


Register 


RX- 
type 


Rel 
Exp 


Abs 
Exp 


Char 


Dec 
Char 


Hex 
Char 


Code* 


(2-12) 


(1) 


(0) 


CTRGROUP 


ctrno 
















X 










sro 
















x 










cttest 
















x 










ID= 
















X 










SROENAB= 
























x 


CTINIT= 
























x 


CTRLIST 


DEVCOD= 
























X 


CTRADR= 
























x 


CTRRD= 
























X 


CTTEST= 
























X 


CTROP= 
























X 


MSG= 


















X 








CTRSCHED 


sched 
















X 










DEULIST 


LENGTH= 




x 






















DIGIT= 
entrypos 
compvalue 
















X 










MSG= 


















X 








MODULU5= 
entrypos 
fid length 
















I 










DIGIT2= 
value pos 
comp value 
















: 










STEND 


no operands 


























TGROUP 


TCn= 
tcode 
E 


* 






















As 


TRUST 


TRID= 
















X 










ROUTE= 
























X 


LOG 
























As 
Shown 


NULL 
























As 
Shown 


TEXT= 
























x 


INQDISP= 
























x 


DEMO D 10= 
























X 


DEMODll = 
























X 


GDU= 
























x 



*See macro description for allowable value 



7-12 OS/VS1 Programmer's Reference Digest 



Line and Station Configuration Supported by BTAM 



Start-Stop Communications 

1. Nonswitched lines (point-to-point or multipoint), using programmed polling: 

IBM 1030 Data Collection System 
IBM 1050 Data Communications System 
IBM 1060 Data Communications System 
IBM 2260 Display Station « 

IBM 2848 Display Control 

(Remote ~ 2701 only) 
IBM 2265 Display Station « IBM 2845 

Display Control (Remote — 2701 only) 
IBM 2740 Communications Terminal (Model 1): 

Basic: with checking 1; with Station Control 2 ; with Checking and Station 

control 2 ; or with Checking and IBM 2760 Optical Image Unit features 

(point-to-point only, if 2740 is equipped with 2760 Optical Image Unit) 

(Model 2): Basic or with Checking • 
IBM 2741 Communications Terminal 
Western Union Plan 115A Outstations 
AT&T 83B3 Selective Calling Stations 

2. Switched lines: 

IBM 1050 Data Communications System 
IBM 2740 Communications Terminal 

(Model 1): Dial; Dial, with Checking; 

Dial, with Transmit Control; Dial, with Checking and 

Transmit Control, or Dial, with Checking and IBM 2760 

Optical Image Unit features 
IBM 2741 Communications Terminal 
WU Model 33/35 Teletypewriter 

Exchange Terminal (TWX) 

3. Nonswitched multipoint lines using the Auto Poll facility (IBM 2702 or 2703 
only); 

IBM 1030 Data Collection System 
IBM 1050 Data Communications System 
IBM 1060 Data Communications System 
IBM 2740 (Model 1 and 2): with Station Control 2 
or with Station Control 2 and Checking features 



'Used as a regular terminal or as an operator's console, when the operating system 
includes the Multiple Console Support. 

2 Station Control feature cannot be used if the 2740 is also used as a console under 
Multiple Console Support. 



Section 7: BTAM/TCAM 7-13 



Line and Station Configuration Supported by BTAM 



Binary Synchronous Communications 

1 . Nonswitched point-to-point and switched point-to-point lines: 
IBM System/370 3 

IBM System/360 Model 20 

IBM System/3 

IBM 1130 Computing System 

IBM 1800 Data Acquisition and Control System 

IBM 2715 Transmission Control Unit (Model 1 attaches directly to 
multiplexer channel of central computer; Model 2 communicates 
with central computer via IBM 2701 or 2703) 

IBM 2770 Data Communications System 

IBM 2780 Data Transmission Terminal 

IBM 3735 Programmable Buffered Terminal 

IBM 3741 Data Station 

IBM 3747 Data Converter 

IBM 3750 Switching System (World Trade users only; nonswitched 

point-to-point line only) 
IBM 3780 Data Communication Terminal 

2. Switched point-to-point 

IBM 3275 Equipped with dial feature 

IBM 5275 Direct Numerical Control Station 

3. Nonswitched multipoint lines: 
IBM System/360 Model 20 
IBM System/3 

IBM 1130 Computing System 

IBM 1800 Data Acquisition and Control System 

IBM 2715 Transmission Control Unit (Model 1 attaches directly to 
multiplexer channel of central computer; Model 2 communicates 
with central computer via IBM 2701 or 2703) 

IBM 2770 Data Communications System 

IBM 2780 Data Transmission Terminal 

IBM 2972 (Models 8 and 11) General Banking Terminal System 

IBM 3270 Display System (remote) 

IBM 3735 Programmable Buffered Terminal (requires special feature) 

IBM 3780 Data Communication Terminal 

IBM 5275 Direct Numerical Control Station 



^he remote System/370 may be a Model 135, 145, 155, 158, 165, 168, or 195. 



7-14 OS/VS1 Programmer's Reference Digest 



TCAM Macros 



Name 


Operation 


Operands 


[ symbol ) 


CANCELMG 


| mask ] f,CONNECT=f AND Vj r,LEVEL=|BLK VI 


[ symbol | 


CHECK 


decbname 


[ symbol ] 


CHECKPT 


(no operands) 


[ symbol 1 


CKREQ 


(no operands) 


[ symbol ] 


CLOSE 


(dcbname,,...)rMF=/L \] 
I l(E,listname)/J 


[ symbol 1 


CLOSE 
(MCP) 


(dcbname, , . . .) 


( symbol ] 


CODE 


["( tablename )"| 
\{ NONE } 
LI (register) J J 


[ symbol | 


COMMBUF 


LIST=name,MAXDEEP, integer 


I symbol ] 


COUNTER 


opfield 


[ symbol 1 


CTBFORM 


[opfield][,DVCID= |NO}][ENDCHAR= (NO)] 

(YES) (YES) 
f,INSERT= {NO>l 
L <YES}J 


[ symbol ] 


CUTOFF 


integer 


(symbol ] 


DATETIME 


pATE^^^ME^NOJJ 


I symbol ] 


ERRORMSG 




mask]f,CONNECT= (AND 

L 'NAND 

7DEST= ( destination name y 

) opfield ( 

/ORIGIN ( 

L 'destin l 

DATA= ( message 1 
(.fieldname/ 
,EXIT=name of routine] 


}] 


[symbol ) 


FORWARD 




DEST= / destname " 
1 opReld 
I (number) 1 

1 ORIGIN I 
V REG(number)/. 

, EOA=characters] 

,EXIT=name] 

,THRESH=integer) 




[symbol ] 


GET 


dcbname [,areaname] 



Section 7: BTAM/TCAM 7-15 



TCAM Macros (cont'd) 



Name 


Operation 


Operands 


grpname 


GROUP 


.[INVLIST=(listname,...)l 
,BUFOUT= {integer} 

<£) 
[,BUFSIZE=integer | 
[BUFMAX= {integer} 

{2)1 
, MH=mhname 
, DCB=dcbname 
[,TRANS=tablename] 










[ symbol 1 


HOLD 


[maskl [, RELEASE] (,INTVL=integer[ 
r,CONNECT= (ANDVj T,LEVEL= I BLK yi 




[ symbol 1 


ICHNG 


grpname, rln, (areaname) [, PASSWRD^chars] 

ACT 
I DEACT ) 




[ symbol ] 


ICOPY 


grpname , rl n , areaname 




[ symbol ) 


INBLOCK 


[ PATH=(opfield. switch)) 




[symbol ] 


INBUF 


[PATrMopfield^witch)) 




[symbol 1 


INEND 


(no operands) 




[symbol ] 


INHDR 


[ PATH=(opfield, switch)) 




[symbol I 


INITIATE 


["concharsrBLANK= jcharv]"] 




[symbol 1 


INMSG 


[PATH=(opf?eld,switch)] 




[ symbol 1 


INTRO 


keyword operands 

,CPB= (integer! 

,ENVIRON= /MIXED) 
I TCAM / 








,FEATURE=( /NODIAL! , / N027411 , / NOTIMERi 
\DIAL J \27£ J I TIMER J 

, MSMAX= / integer! 

170 J 
,MSMIN= / integer \ 

\50 } 
,MSUNITS= /integer) 
\9_ / 


( NO3705 ] 
\ MIXD3705 \ 
(ONLY3705> 


" M 


INVLIST 


ORDER=(entry,...) [,EOT=hexcharsl [,CPUID=addr] [,MASTER= / YES \ ] 

\ NO/ 


[symbol | 


LOCK 


(EXTEND ) r,concharsr,BLANK= (YES)"|"| 

WssAGE H I \tj\\ 




[symbol | 


LOCOPT 


opReld, /(register)! 
1(15) | 




[symbol ] 


LOG 


(dcbname \ 
ItypenameJ 





7-16 • OS/VS1 Programmer's Reference Digest 



TCAM Macros (cont'd) 



Name 


Operation 


Operands 


typename 


LOGTYPE 


dcbname,BUFSIZE=size,QUEUES=form 


[ symbol J 


MCOUNT 


DCB= / name 1 
l(r) / 


[ symbol 1 


MCPCLOSE 


(QUICK \ [,PASSWRD=chars] 
I FLUSH / 


[ symbol 1 


MHGET 


{WORK= {(register)} [, RESERVE- {YES}] 
{name} {NO} 
{ REG=(register) } 
WORK= {(register)} [ ,RESERVE=integer I 


[ symbol ] 


MHPUT 


I symbol 1 


MRCHECK 


(no operands) 


[ symbol ] 


MRELEASE 


statname |, PASSWRD=chars ] 


[ symbol ] 


MSGEDIT 


((groupl),(grou P 2),...),BLANK= (NO ) 
{ char } 

(yes) 


I symbol ] 


MSGFORM 


[BLOCK=integer|[,SUBBLCK=integer] 
[,COUNT=integerl f,SENDTRP= ( YES, PAD ) "1 

|,ENDCHAR=subblock delimiterl 
I.LC=MN \ 

\ out r 


[ symbol ] 


MSGGEN 


| mask I, f message ) 
I fieldname ) 
r,CONNECT= I ANDV] 


( symbol J 


MSGLIMIT 


/ integer ) 
\ opReld f 


[ symbol ] 


MSGTYPE 


f/conchars (pLANK- ( YES )~| 

r BLE — EXIT ™' 1 \tJ 


[ symbol ] 


OPEN 


(dcbname )r,MF=/L \1 

L \(E,listname)/J 


[ symbol 1 


OPEN 
(MCP) 


(dcbname, ft, OUTPUT )[ ,IDLE])"1, •• .) 
\ INOUT } 
l{ INPUT ) J 
17 MF=L n 
LI MF=(E,listname)/J 


opfldname 


OPTION 


typelength 


1 symbol ] 


ORIGIN 


f integer "| 
LX'FF' J 

(",form= md n 

L I NAME /J 


[ symbol ] 


OUTBUF 


[ PATH=(o P Reld,switch)l 



Section?: BTAM/TCAM 7-17 



TCAM Macros (cont'd) 



Name 


Operation 


Operands 


[ symbol ] 


OUTEND 


(no operands) 




[symbol] 


OUTHDR 


[PATH=(opfIeld,swirch)] 




[ symbol 1 


OUTMSG 


[PATH=(opfield, switch) ] 




[ symbol ] 


PATH 


switch, opfieldr,concharsr,BLANK= fYES j 


]] 


pcbname 


PCB 


MH=mhname,BUFSIZE=integer 

[*,BUFIN= (number! ~| r,BUFOUT= ( number)"! 

1, RES ERVE=(integerl , i nteger2) ] 
[,SFLAG= /YES), 
iNO/ 1 
I, DATE- /YES). 
tNO/ 1 


[ symbol ) 


POINT 


dcbname, address 




[ symbol ] 


PRIORITY 


[integer] Tconchars T,BLANK= (YES I 1 










[symbol] 


PUT 


dcbname [ , areaname ] 




[ symbol ] 


QACTION 


TYPE= {A> ,EXIT=name 
{V) 




[symbol] 


QCOPY 


termname, areaname [,LIMIT= /integer \, 
\ (register) ] ] 




[ symbol ] 


Q RESET 


dcbname, MAX=integer 




[ symbol ] 


QSTART 


(no operands) 




[ symbol ] 


READ 


decbname,SF, dcbname, areaname, 
/length) [MF= /L \, 
W I \(E,!istnam e )J ] 




[ symbol ] 


READY 


[GMMSG=routine] [,RSMSG=routine] 




[ symbol ] 


REDIRECT 


[mask] r,CONNECT= |AND)"| 

[7DEST= (destname)] 
opfield 

L ( origin) J 




[symbol ] 


RETRY 


INTVL=integer 




[symbol ] 


SCREEN 


/WRE^ nconcharsr,BLANK= ( YES ).]"] 
\WLAJ < NO M 
JWDCl L L (char)JJ 
)XRE ( 
/XLA \ 
VXDC'' 




[ symbol ] 


SEQUENCE 


(no operands) 





7-18 0S/VS1 Programmer's Reference Digest 



TCAM Macros (cont'd) 



Name 


Operation 


Operands 


[symbol] 


SETEOF 


f"concharsr,BLANK= (YES)~|"1 


[symbol ] 


SETEOM 


L L '•char-'-'-' 

[ENDCHAR= / chars )] [EOM=ETB] 
L lopfield/J 
[,LENGTH=( /integer! ,o P Reld2)"| 
L topfieldl/ J 
r,PROCESS= /YES!"] |",REMOVE= (YES)"] 


[symbol ] 


SETSCAN 


/skipchars) HBLANK= (YES)"] 
tinteger / \ NO > 










L (char)J 






[,POINT= /BACK n [,MOVE= /RETURN)] 
L IFORWARD/J L IKEEP /J 






r,RESULT= ( (register) Y\ 


[symbol ] 


SLOWPOLL 


[mask] [,CONNECT= {AND} ][,SECONDS= {integer}] 
{OR.} {60} 


mhname 


STARTMH 


LC= /IN \p/STOP ) =/YES \] 
IOUT/L ICONT/ \(opfield, switch)/] 










f,CONV= (YES )~\ 






^(opfield,switch)H 






L (no )J 






f",LOGICAL= /(opfield) )"| 
L I (opfieldl. switch, opfield2)/J 










[' BREG= {T 9er }]p LMD= rNo w 


[symbol ] 


TCHNG 


L ((c^rield, switch)) J 
termname,areaname [,PASSWRD=chars ] 


[symbol ] 


TCOPY 


statname,areaname 


[symbol ] 


TERMINAL 


QBY= rTH,DCB=dcbname ) ,RLN=infeger.TERM=rype 
lUl,GROUP=grpname/ 










T ( REMOTE)") 






,QUEUES=form ,DIALNO= < chars > [,ADDR =chars] 






L (none )J 






|,LEVEL=(integer, . . .)] !,CLOCK=timel 






[,CINTVL=integer] [,BUFSIZE=inreger] 






|,ALTDEST=entry] LBFDELAY=integer| 






^NTBLKSZ^blocksize^ubblocksize)] 






I,TBLKSZ=integer| [,OPDATA=(data, . . .)] 






|,RETRY=integer] TLMD= /YES)"] HMB= /YES)"] 






TSECTERM= /YES)] nFEA7URE= /ATTN )] 
L iNOiJ L INOATTN/J 






[C omp. a] ~ ,j«n 






~ L (noJJ 






[,GPCLSTR=clustername ] 






|,ACTIVE= /YES), 
(NO/ 1 






I,SPECOUT= JYES1, 
INO/ 1 













Section 7: BTAM/TCAM 7-19 



TCAM Macros (cont'd) 



Name 


Operation 


Operands 


[symbol] 


TERMINAL 
(continued) 


r,DVCID= ( (CONC[, integer] )Y\ 

L ( NONE )J 

f,QCNTRL=( J (MSG[W msgcountVl) I 

V bytecount ' 
UJL STATUS] [, c har])| 
(,CTBMAX=integer] J 


[ symbol J 


TERRS ET 


(no operands) 


[symbol] 


TGOTO 


MH= {name of MH) 
{opfield} 


[symbol] 


TLIST 


TYPE=J D ),LIST=(entry,entry,...) 
DCB= < name ) f\RECDLM= ( YES VI 


[symbol] 


TPDATE 






[■ DTSME N°r}p ELnE "{^}] 


[ name ] 


TPEDIT 


MINLN=n,EDIT= i EDITR \,RECFM= t\)\, 
\ EDITD/ IV/ 

ERPROT= / name \ ,VERCHK= f VOKCHK \ 
X IGNORE f I NOCHK / 

REPLACE= / X'xx' \ ,BUFFER= / YES \ 
X X'19'J I NO/ 


procname 


TPROCESS 


PCB=pcbname (,QUEUES=form ] (, ALTDEST=entry 1 

[• CKmYN 1 Y ^}][' DATE '{^}] 

T,SECTERM= (YES VjUECDEL=delimifer ] 
[ ,LEVEL=(integer, . . .)1 [,OPDATA=(data, . . .)] 

[' QBACK 1S}] 


[ symbol] 


TTABLE 


LAST=name [ f MAXLEN=integer] [,OLTERM=n] 


[ symbol] 


TYPETABL 


conchar, ROUTINE=name 


[ symbol] 


UNLOCK 


|"concharsrBLANK=| YES VT1 


[ symbol] 


WRITE 


decbname, SF, dcbname, areaname. / length \ 



7 • 20 OS/VS 1 Programmer's Reference Digest 



TCAM Operator Commands 



Control Char* 


Operation 


Operands 


control chart 


(DISPLAY) 
(D) 


< 


^TP.ACT, {grpname,rln ) 
( address > 

TP,ADDR,statname 

TP,INACT, 1 grpname.rln } 
{ oddress ) 

TP, INTER 

TP,LINE, { grpname,rln ) 
{ address } 

TP,LINE, INACTIVE 

TP,LIST, (grpname.rln) 
(address } 

TP, OPTION, statname.opfldname, < C > 

TP,PRITERM 

TP,QUEUE,statname 

TP,SECTERM 

TP, STATUS, ( d ^ ame l 
(address ) 

TP,STORE,( dd " ame },aaaaa 
I address ; 

^TP,TERM,stafname , 


> 


control chars 


{HALT} 

(z) 


TP, (QUICK) 
(FLUSH) 


control chars 


(HOLD) 
(H> 


TP =statname 


control chars 


(MODIFY) 
(F) 


< 


procname.id 
id J 
jobname 
procname 


',ACTIV= (ddname ) [,IDLE ] ' 
(address ) 

,AUTOPOLL= { grpname.rln ),|ON) 
( address } I OFF / 

,BACKUP=( ddname } 
{ address } 

,BHSET=statname, { C ) f,oaal 
(A) 
( D> 

,BTRACE={ linename ), (ON 

{ grpname.rln } (OFF ) 

,CHANL={ ddname ) 
{ address } 

,CHNGMODE= ( grpname.rln } [,AUTO] 

{ grpname[,ALL ] ) [.MANUAL] 


> 



Section?: BTAM/TCAM 7-21 



TCAM Operator Commands (cont'd) 



{MODIFY} 
(F> 

(cont'd) 



jobname 
procname 



,DEACT= {ddname) , [QUICK] 
{address} [ FLUSH ] 

,DEBUG={L} , {IEDQFE10} 

{D} {IEDQFE20} 

{IEDQFE30} 

,DUMP= {ddname} 
{address } 

,INTENSE={LINE, { grpname,rln J } , 
{ address } 
{ TERM,starname} 



,INTERVAL=POLL,! 



data, {S } 
{N} 



,INTERVAL=SYSTEM[,data] 

,IPL= {ddname} 
{ address } 



, LOAD= { ddname ] 
{ address ) 



< ,OPERATOR={ starname } 
{ SYSCON } 



, OPT=statname , opf I dname 
,SESSION=grpname,rln,ac 



{EP} 
{NCP} 



,{H} 
{L } 



statnamel , Statname2 



,SWBACK= { ddnarael } , { ddname2 } 
{address! } { address2 } 



■,[P] 
[B[grpname,rln]] 



,SWITCH= {ddname} 
{ address ) 

,TIMEDAT={ ddname} 
{ address } 

,TRACE= {grpname,rln } , 
{ address } 
{ addr3705/addrlin 

, TRANLMT=stafname, aaa 



:, [count] 
[15] 



{ON} ,< 
{OFF} 



7 - 22 OS/ VS 1 Programmer's Reference Digest 



TC AM Operator Commands (cont'd) 



Control Chars 


Operation 


Operands 


control chars 


< RELEASE 
{A} 


TP=statname 


control chars 


{ VARY } 
{V} 


< 


r ( e ) ~s 

gpsfatname,ONTP, j J 

statname,ONTP,B 
statname,ONTP,E 

gpstatname,OFFTP,j „ j 
statname,OFFTP,| BM | 

statname,OFFTP,{ EM | 

{( 9 rpname,rln)} ,OFFTP, (c) 
{(grpname,)} {| } 
{ address } 
{(grpname, ALL)} 

{ (grpname, rln) } ,ONTP 

{(grpname,)} 

{ address } 

^(grpname, ALL)} J 


> 



Section 7: BTAM/TCAM 7-23 



Device Configurations Supported by TCAM 




2701 
BSC 




IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 

IBM 2741 Communication Terminal 

IBM 2760 Optical Image Unit 

IBM 2843/2260 Display Complex (Remote) 

IBM 2845/2265 Display Complex (Remote) 

AT&T 83B3 Selective Calling Stations 

WUPIan 115A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 

IBM 2770 Data Communication System 

IBM Data Transmission Terminal 

IBM 1130 Computing System 

IBM 2790 Data Communication System 

IBM 2922 Programmable Terminal 

IBM 3270 Information Display System 

IBM 3670 Brokerage Communication System 

IBM 3735 Programmable Buffered Terminal 

IBM 3740 Data Entry System 

IBM 3780 Data Communication Terminal 

IBM System 3 

IBM System/360 Model 20 

IBM System/360 Models 25 and above 

IBM System/370 Models 135 and above 

IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 

IBM 2741 Communication Terminal 

IBM 2760 Optical Image Unit 

AT&T 83B3 Selective Calling Stations 

WUPIan 115A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 

IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 

IBM 2741 Communication Terminal 

IBM 2760 Optical Image Unit 

IBM 2770 Data Communication System 

IBM 2780 Data Transmission Terminal 

IBM 2790 Data Communication System 

IBM 2922 Programmable Terminal 

IBM 3270 Information Display System 

IBM 3670 Brokerage Communication System 

IBM 3735 Programmable Buffered Terminal 

IBM 3740 Data Entry System 

IBM 3780 Data Communication Terminal 

IBM System 3 

IBM System/360 Model 20 

IBM System/360 Models 25 and above 

AT&T 83B3 Selective Calling Stations 

WUPIan 115A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 

IBM System/370 Models 135 and above 

IBM 2260 Display Complex (Local) 



7-24 OS/VS1 Programmer's Reference Digest 




Device Configurations Supported by TCAM (cont'd) 

.IBM 3270 Information Display System (Local) 

Start-Stop Terminals 

IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communications Terminal, Models 1 and 2 

IBM 2741 Communications Terminal 

IBM 2760 Optical Image Unit (via the IBM 2740 Communications 

Terminal, Model 1) 
IBM 2845/2265 Display Complex 
IBM 2848/2260 Display Complex 
IBM System 7 (supported as an IBM 2740 Communications 

Terminal, Model 1, with the Record Check feature) 

Binary Synchronous Terminals 

IBM 2270 Data Communications System 

IBM 2780 Data Transmission Terminal (no support for Transcode) 

IBM 2922 Programmable Terminal 

IBM 3270 Information Display System 

IBM 3670 Brokerage Communication System (supported only in 

the United States and Canada) 
IBM 3735 Programmable Buffered Terminal 
IBM 3780 Data Communication Terminal 

Transmission Control Units (BSC support only) 

IBM 2701 Data Adapter Unit (with Synchronous Data Adapter Type II) 
IBM 2703 Transmission Control (with Synchronous Terminal Control) 
IBM 2715 Transmission Control, Model 2 
IBM 3705 Communications Controller 

Note: The IBM 2701 , IBM 2703, and IBM 3705 control units are 
supported only when attached locally to an IBM System/360 or 
System/370. 



Computers (BSC support only) 

IBM 1130 Computing System (with Synchronous Communications 
Adapter) 

IBM System 3 

IBM System/360, Model 20 (with Binary Synchronous Com- 
munications Adapter) 

IBM System/360, Model 25 and above (with Integrated Com- 
munications Attachment with Synchronous Data Adapter II) 

IBM System/370, Model 135 and above (with Integrated Com- 
munications Attachment with Synchronous Data Adapter II) 

Other Devices 

• World Trade teleprinters that use CCITT=2 or =5 code leased 
point-to-point, leased multipoint, or switched network lines. 

• Terminals using the following line control disciplines: 

AT&T 83B3 or WU 115A start-stop code, over point-to-point o 
multipoint leased telegraph lines: AT&T CPT-TWX (33/35) 
start-stop code over switched lines. 



Attachment of non-IBM device is under the provisions of the 
IBM Multiple Supplier Systems Policy. 



Section 7: BTAM/TCAM 7-25 



Device Configurations Supported by TCAM (cont'd) 

Start-Stop Terminals 



3705 with 
the Network 
Control 
Program 



IBM 1050 Data Communication System 

IBM 2740 Communications Terminal, Models 1 and 2 

IBM 2741 Communications Terminal 

IBM System/7 (supported as an IBM 2740 Communica- 
tions Terminal Model 1, with the Record Check 
feature) 

Binary Synchronous Terminals 



IBM 2770 Data Communication System 

IBM 2780 Data Transmission Terminal (no support for 

Transcode) 
IBM 2972 General Banking Terminal System, Models 8 

and 11) 
IBM 3270 Information Display System 
IBM 3735 Programmable Buffered Terminal 
IBM 3780 Data Communication Terminal 

Transmission Control Units (BSC support only) 

IBM 2701 Data Adapter Unit (with Synchronous Data 

Adapter Type II) 
IBM 2703 Transmission Control (with Synchronous 

Terminal Control) 
IBM 2715 Transmission Control Model 2 
IBM 3705 Communications Controller 

Note: The IBM 2701, IBM 2703, and IBM 3705 control 
units are supported only when attached locally to an 
IBM System/360 or System/370. 



Computers (BSC support only) 

IBM System/3 

IBM System/360, Model 20 (with Binary Synchronous 

Communications Adapter) 
IBM System/360, Model 25 and above (with Integrated 

Communications Attachment with Synchronous Data 

Adapter) 
IBM System/370, Model 135 and above (with Integrated 

Communications Attachment with Synchronous Data 

Adapter' II) 
IBM 1 130 Computing System (with Synchronous 

Communications Adapter) 
IBM 1800 Data Acquisition and Control System (with 

IBM 1826 Data Adapter Unit with Communication 

Adapter) 

Other Devices 

• World Trade teleprinters that use CCITT No. 2 or 
No. 5 code on leased point-to-point lines. 

• Terminals using the following line control disci- 
plines: AT&T 83B3 or WU 115A start -stop code, 
over point-to-point or multipoint leased telegraph 
lines: AT&T CPT-TWX (33/35) start-stop code 
over switched lines. 

Attachment of non-IBM terminals is under the pro- 
visions of the IBM Multiple Supplier Systems Policy. 



7-26 OS/VS1 Programmer's Reference Digest 



Device Configurations Supported by TCAM (cont'd) 







Channel Type 


TCU 


Audio 

Response 

Unit 


Line Type 


Notes 


Station Type 


Multi- 
plexer 


Selector 


IBM 2701 
Data 
Adapter 
Unit 


IBM 2702 
Trans- 
mission 
Control 


IBM 2703 
Trans- 
mission 
Control 


IBM 3705 
EP 

Comm 
Con- 
troller 


IBM 3705 
NCP 
Comm 
Con- 
troller 


IBM 7770 
Model 3 


Switched 


Non- 
Switched 


IBM 1030 Data 
Collection System 


Auto 
Poll 


X 






X 


X 


X 








X 


The IBM Digital Time Out 
feature cannot be attached 
through an IBM 2701 TCU. 




X 




X 


X 


X 


X 








X 


IBM 1050 Data 
Communication System 


Auto 
Poll 


X 






X 


X 


X 








X 






X 




X 


X 


X 


X 


X 




X 


X 


IBM 1060 Data 
Communication System 


Auto 
Poll 


X 






X 


X 


X 








X 






X 




X 


X 


X 


X 








X 


IBM 2260-2848 Display 
Complex (Remote) 




X 




X 






X 








X 




IBM 2260-2848 Display 
Complex (Local) 




X 


X 




















IBM 2265-2845 Display 
Complex (Remote) 




X 




X 






X 








X 




IBM 2740 Model 1 

Communication 

Terminal 


Auto 
Poll 


X 






X 


X 


X 








X 


Two Types: 

2740 with station control 
2740 with station control and 
record checking 




X 




X 


X 


X 


X 


X 






X 


Four Types: 

2740 basic 

2740 with station control 

2740 with record checking 

2740 with station control 

and record checking 




X 




X 


X 


X 


X 






X 




Four Types, all with dial: 

2740 

2740 with transmit control 

2740 with record checking 

2740 with transmit control 

and record checking 


IBM 2740 Model 2 

Communication 

Terminal 


Auto 
Poll 


X 






X 


X 


X 


X 






X 


Four Types: 

2740 

2740 with record checking 

2740 with buffer receive 

2740 without buffer receive 

(requires lines slowdown feature) 




X 




X 


X 


X 


X 








X 


Four Types: 

2740 

2740 with record checking 

2740 with buffer receive 

2740 without buffer receive 



Section 7: BTAM/TCAM 7-27 



Device Configurations Supported by TCAM (cont'd) 







Channel Type 


TCU 


Audio 

Response 

Unit 


Line Type 


Notes 


Station Type 


Multi- 
plexer 


Selector 


IBM 2701 
Data 
Adapter 
Unit 


IBM 2702 
Trans- 
mission 
Control 


IBM 2703 
Trans- 
mission 
Control 


IBM 3705 
EP 

Comm 
Con- 
troller 


IBM 3705 
NCP 

Con- 
troller 


IBM 7770 
Model 3 


Switched 


Non- 
Switched 


IBM 2741 

Communication 

Terminal 




X 




X 


X 


x i 


X 


X 




X 


X 




IBM 1130 Computing 
System 




X 




X 




X 


X 


X 




X 


X 


BSC transmission 


IBM 1800 Data 
Acquisition System 
















X 










IBM 2760 Optical 
Image Unit 




















X 


X 


Attached to a 2740 Model 1 with 
record checking 


IBM 2770 Data 
Communication 
System 




X 




X 




X 


X 


X 




X 


X 


BSC transmission using either 
ASCII or EBCDIC code 


IBM 2780 Data 
Transmission Terminal 




X 




X 




X 


X 


X 




X 


X 


BSC transmission ASCII, EBCDIC, 
or 6-bit code 


IBM 2790 Data 
Communications 
System 




X 




X 




X 


X 


X 




X 


' X 




IBM 2972 General 
Banking Terminal 
















X 










IBM 3270 Information 
Display System 




X 




X 




X 


X 


X 






X 




IBM 3670 Brokerage 

Communication 

System 




X 




X 




X 


X 








X 


BSC transmission using EBCDIC 
code 


IBM 3735 Program- 
mable Buffered 
Terminal 




X 




X 




X 


X 


X 




X 


X 


Either ASCII or EBCDIC 


IBM 3740 Data Entry 
System 




X 




X 




X 


X 






X 


X 


BSC Transmission code TERM= 
BSCI or TERM=BSC2 on 
TERMINAL macro 


IBM 3780 Data 
Communication 
Terminal 




X 




X 




X 


X 


X 




X 


X 


BSC transmission using either 
ASCII or EBCDIC code 


IBM System 3 




X 




X 




X 


X 


X 




X 


X 


Code TERM=202A or TERM=202B 
on TERMINAL. Macro inquiry/ 
response not supported 


IBM System 7 
















X 










IBM System/360 
Model 20 




X 




X 




X 


X 


X 




X 


X 


BSC transmission using either 
ASCII or EBCDIC code 



7 - 28 OS/ VS 1 Programmer's Reference Digest 



Device Configurations Supported by TCAM (cont'd) 







Channel Type 


TCU 


Audio 

Response 

Unit 


Line Type 


Notes 


Station Type 


Multi- 
plexer 


Selector 


IBM 2701 
Data 
Adapter 
Unit 


IBM 2702 
Trans- 
mission 
Control 


IBM 2703 
Trans- 
mission 
Control 


IBM 3705 
EP 

Comm 
Con- 
troller 


IBM 3705 
NCP 
Comm 
Con- 
troller ' 


IBM 7770 
Model 3 


Switched 


Non- 
Switched 


IBM System/360 Model 
25 and above 




X 




X 




X 


X 


X 




X 


X 


BSC transmission and point-to- 
point lines only 


IBM System/370 Model 
135 and above 




X 




X 




X 


X 


X 




X 


X 


BSC transmission and point-to- 
point lines only 


IBM System/370 Model 
135 Integrated 
Communication 
Attachment 
















X 










AT & T 83B3 Selective 
Calling Station 




X 




X 


X 


X 


X 


X 






X 




Western Union Plan 
115A Outstations 




X 




X 


X 


X 


X 


X 






X 




TWX Models 33 and 35 




X 




X 


X 


X 


X 


X 




X 




Teletype terminals, dial service 
(8 level code) 


World Trade Telegraph 
Terminals 




X 




X 


X 


X 


X 


X 






X 


Control unit must incorporate a 
WTTA 


Audio terminals 




X 














X 


X 




Example IBM 2721 Portable 
Audio Terminal 



Section 7: BTAM/TCAM 7-29 



7-30 OS/VS1 Programmer's Reference Digest 



Section 8: Utilities 



Utility Programs - Listed by Class 8-2 
Guide to Utility Program Functions 8-3 



IBCDASDI 


8-5 


IEBTCRIN 


8-21 


IBCDMPRS 


8-7 


IEBUPDTE 


8-26 


ICAPRTBL 


8-8 


IEHATLAS 


8-29 


IEBCOMPR 


8-9 


IEHDASDR 


8-30 


IEBCOPY 


8-10 


IEHINITT 


8-33 


IEBDG 


8-12 


IEHIOSUP 


8-34 


IEBEDIT 


8-15 


IEHLIST 


8-35 


IEBGENER 


8-16 


IEHMOVE 


8-36 


IEBISAM 


8-18 


IEHPROGM 


8-39 


IEBPTPCH 


8-19 


IFHSTATR 


8-42 



Definition of Operands 8-43 



Source Publications 



Additional information is contained in OS/VS Utilities, GC3 5-0005. 



Section 8: Utilities 8-1 



Utility Programs - listed by class 



SYSTEM 


DATA SET 


INDEPENDENT 


Utility Programs 


Utility Programs 


Utility Programs 


IEHATLAS 


IEBCOMPR 


IBCDASDI 


IEHDASDR 


IEBCOPY 


IBCDMPRS 


IEHINITT 


IEBDG 


ICAPRTBL 


IEHIOSUP 


IEBEDIT 




IEHLIST 


IEBGENER 




IEHMOVE 


IEBISAM 




IEHPROGM 


IEBPTPCH 




IFHSTATR 


IEBTCRIN 
IEBUPDTE 





The utilities section is arranged in alphabetical order for easy reference. 

The control statement for the utility programs have the following standard format: 



I label operation operand I 

The label symbolically identifies the control statement. When included, a label must 
begin in the first position of the statement and must be followed by one or more blanks. 
It can contain from one to eight alphameric characters, the first of which must be 
alphabetic. 

The operation identifies the type of control statement. It must be preceded and followed 
by one or more blanks. 

The operand is made up of one or more keyword parameters separated by commas. The 
operand field must be preceded and followed by one or more blanks. Commas, paren- 
theses, and blanks can be used only as delimiting characters. 

A definition of operands table is located at the back of this section. It should be used, 
when needed, as a recall mechanism; it is not intended for use as tutorial information. 
If you require additional information, refer to the source publication listed for this 
section. 



8-2 OS/VS1 Programmer's Reference Digest 



Guide to Utility Program Functions 



Task 


Utility Program 


Add 


a password 


IEHPROGM 


Analyze 


tracks on direct access 


IEHATLAS, IEHDASDR, 
IBCDASDI 


Assign alternate 
tracks 


to a direct access volume 


IEHATLAS, IEHDASDR, 
IBCDASDI 


Build 


a generation index 


IEHPROGM 


a generation 


IEHPROGM 


an index 


IEHPROGM 


Catalog 


a data set 


IEHPROGM 


a generation data set 


IEHPROGM 


Change 


data set organization 


IEBUPDTE 


logical record length 


IEBGENER 


volume serial number of direct access 
volume 


IEHDASDR 


Compare 


a partitioned data set 


IEBCOMPR 


sequential data sets 


IEBCOMPR 


Compress-in- 
place 


a partitioned data set 


IEBCOPY 


Connect 


volumes 


IEHPROGM 


Construct 


records from MTST and MTDI input 


IEBTCRIN 


Convert to 
partitioned 


a sequential data set created as a result 
of an unload 


IEBCOPY 


sequential data sets 


IEBUPDTE, IEBGENER 


Convert to 
sequential 


a partitioned data set 


IEBUPDTE, IEBCOPY 


an indexed-sequential data set 


IEBISAM, IEBDG 


Copy 


a catalog 


IEHMOVE 


a direct access volume 


IEHDASDR, IBCDMPRS, 
IEHMOVE 


a partitioned data set 


IEBCOPY, IEHMOVE 


a volume of data sets 


IEHMOVE 


an indexed-sequential data set 


IEBISAM 


cataloged data sets 


IEHMOVE 


dumped data from tape to direct access 


IEHDASDR, IBCDMPRS 


job steps 


IEBEDIT 


members 


IEBGENER, IEBUPDTE, 
IEBDG 


selected members 


IEBCOPY, IEHMOVE 


sequential data sets 


IEBGENER, IEHMOVE, 
IEBUPDTE 


to tape 


IBCDMPRS 


Create 


a library of partitioned members 


IEBUPDTE 


a member 


IEBDG 


a sequential output data set 


IEBDG 


an index 


IEHPROGM 


an output job stream 


IEBEDIT 


Delete 


a password 


IEHPROGM 


an index structure 


IEHPROGM 


records in a partitioned data set 


IEBUPDTE 


Dump 


a direct access volume 


IEHDASDR, IBCDMPRS 


Edit 


MTDI input 


IEBTCRIN 


Edit and convert 
to partitioned 


a sequential data set 


IEBGENER, IEBUPDTE 


Edit and copy 


a job stream 


IEBEDIT 


a sequential data set 


IEBGENER, IEBUPDTE 


Edit and list 


error statistics by volume (ESV) records 


IFHSTATR 


Edit and print 


a sequential data set 


IEBPTPCH 


Edit and punch 


a sequential data set 


IEBPTPCH 


Enter 


a procedure into a procedure library 


IEBUPDTE 


Exclude 


a partitioned data set member from a copy 
operation 


IEBCOPY, IEHMOVE 


Expand 


a partitioned data set 


IEBCOPY 


a sequential data set 


IEBGENER 


Generate 


test data 


IEBDG 


Get alternate 
tracks 


on a direct access volume 


IEHDASDR, IBCDASDI, 
IEHATLAS 



Section 8: Utilities 8-3 



Guide to Utility Program Functions (cont'd) 



Task 


Utility Program 


Include 


changes to members or sequential data sets 


IEBUPDTE 


Initialize 


a direct access volume 


IEHDASDR, IBCDASDI 


Insert records 


into a partitioned data set 


IEBUPDTE 


Label 


magnetic tape volumes 


IEHINITT 


List 


a password entry 


IEHPROGM 


a volume table of contents 


IEHLIST 


contents of direct access volume on system 
output device 


IEHDASDR 


number of unused directory blocks and 
tracks 


IEBCOPY 


partitioned directories 


IEHLIST 


the contents of the catalog (SYSCTLG 
^data set) 


IEHLIST 


Load 


a previously unloaded partitioned data set 


IEBCOPY 


an indexed sequential data set 


IEBISAM 


an unloaded data set 


IEHMOVE 


UCSand FCB buffers of a 3211 


ICAPRTBL 


Merge 


partitioned data sets 


IEHMOVE, IEBCOPY 


Modify 


a partitioned or sequential data set 


IEBUPDTE 


Move 


a catalog 


IEHMOVE 


a volume of data sets 


IEHMOVE 


cataloged data sets 


IEHMOVE 


partitioned data sets 


IEHMOVE 


sequential data sets 


IEHMOVE 


Number records 


in a new member 


IEBUPDTE 


in a partitioned data set 


IEBUPDTE 


Password protect 


add a password 


IEHPROGM 


delete a password 


IEHPROGM 


list, passwords 


IEHPROGM 


replace a password 


IEHPROGM 


Print 


a sequential data set 


IEBGENER, IEBUPDTE, 
IEBPTPCH 


partitioned data sets 


IEBPTPCH 


selected records 


IEBPTPCH 


Punch 


a partitioned data set member 


IEBPTPCH 


a sequential data set 


IEBPTPCH 


selected records 


IEBPTPCH 


Read 


Tape Cartridge Reader input 


IEBTCRIN 


Reblock 


a paritioned data set 


IEBCOPY 


a sequential data set 


IEBGENER, IEBUPDTE 


Recover 


data from defective tracks on direct access 
volumes 


IEHATLAS 


Release 


a connected volume 


IEHPROGM 


Rename 


a partitioned data set member 


IEBCOPY, IEHPROGM 


a sequential or partitioned data set 


IEHPROGM 


moved or copied members 


IEHMOVE 


Renumber 


logical records 


IEBUPDTE 


Replace 


a password 


IEHPROGM 


data on an alternate track 


IEHATLAS 


identically named members 


IEBCOPY 


logical records 


IEBUPDTE 


members 


IEBUPDTE 


records in a member 


IEBUPDTE 


records in a partitioned data set 


IEBUPDTE, IEBCOPY 


selected members 


IEBCOPY 


selected members in a move or copy 
operation 


IEHMOVE, IEBCOPY 


Restore 


a dumped direct access volume from tape 


IBCDMPRS, IEHDASDR 


Scratch 


a volume table of contents 


IEHPROGM 


data sets 


IEHPROGM 


Uncatalog 


data sets 


IEHPROGM 


Unload 


a partitioned data set 


IEHMOVE, IEBCOPY 


a sequential data set 


IEHMOVE 


an indexed sequential data set 


IEBISAM 


Update 


in place a partitioned data set 


IEBUPDTE 


TTR Entries in the supervisor call library 


IEHIOSUP 


Write 


IPL records and a program on a direct access 


IEHDASDR 



8-4 0S/VS1 Programmer's Reference Digest 



IBCDASDI 

IBCDASDI, an independent utility: 

• Assigns alternate tracks to a direct access volume. 

• Initializes a direct access volume. 

Job Control Statements 

Because IBCDASDI is an independent utility, operating-system job control 
statements are not used. 

Control Statements 



JOB 


indicates the beginning of an IBCDASDI job. 


MSG 


defines an output device for operator messages. 


DADEF 


defines the volume to be initialized. 


VLD 


contains information for constructing an initial volume 
label and for allocating space for additional labels. 


VTOCD 


contains information for controlling the location of the 
volume table of contents. 


IPLTEXT 
(optional) 


separates utility control statements from any IPL program 
text statements. 


GETALT 


assigns an alternate track on a volume. 


END 


indicates the end of an IBCDASDI job. 


LASTCARD 
(optional) 


used to end a series of stacked IBCDASDI jobs. 



VTOC Entries per Track 



Device 


VTOC Entries per Track 


2314 


25 


2319 


25 


2305-1 


18 


2305-2 


34 


3330 


39 



Section 8: Utilities 8-5 



IBCDASDI (cont'd) 

Format 



Name 


Operation 


Operands 


[label] 


JOB 


[user-in formation] 


[label] 


MSG 


TODEV=xxxx 
,TOADDR=cuu 


[label] 


DADEF 


TODEV=xxxx 
,TOADDR=cuu 
l,IPL=YES] 

,VOLID=/serial \ 
^SCRATCH / 
[,FLAGTEST=NO] 
[,PASSES=n] 
[,BYPASS=YES] 
[,MODEL=n] 


[label] 


VLD 


NEWVOLID=serial 
jVOLPASS^Oj 

[,OWNERID=xxxxxxxxxx] 
[,ADDLABEL=n] 


[label] 


VTOCD 


STRTADR=nnnnn 
,EXTENT=nnnn 




IPLTXT 




[label] 


GET ALT 


TODEV=xxxx 

,TOADDR=cuu 

,TRACK=cccchhhh 

^OL^Serial 

[,FLAGTEST=NO] 
[,PASSES=n] 
[,BYPASS=YES] 
[,MODEL=n] 


[label] 


END 


[user-information] 




LASTCARD 





8-6 0S/VS1 Programmer's Reference Digest 



IBCDMPRS 

IBCDMPRS, an independent utility: 

• Copies a direct access volume. 

• Copies dumped data from tape to a direct access volume. 

• Copies to tape. 

• Dumps a direct access volume. 

• Restores a dumped direct access volume from tape. 



Job Control Statements 

Because IBCDMPRS is an independent utility, operating-system job control 
statements are not used. 

Control Statements 



JOB 


begins an IBCDMPRS job. 


MSG 


defines an output device for operator messages. 


DUMP 


identifies the volume to be dumped and the receiving volume. 


VDRL 


specifies the upper and lower track limits of a partial dump. 


RESTORE 


identifies the source volume whose data is to be restored and the 
receiving volume. 


END 


indicates the end of an IBCDMPRS job. 



Name 


Operation 


Operands 


[label] 


JOB 


[user-information] 


[label] 


MSG 


TODEV=xxxx 
,TOADDR=cuu 


[label] 


DUMP 


FROMDEV=xxxx 

,FROMADDR=cuu 

,TODEV=xxxx 

,TOADDR=cuu 

i,VOLID=serial[, serial]] 

[,MODE=mm] 

[,MODEL=n] 


[label] 


VDRL 


BEGIN=nnnnn 
[,END=nnnnn] 


[label] 


RESTORE 


FROMDEV=xxxx 

,FROMADDR=cuu 

,TODEV=xxxx 

,TOADDR=cuu 

,VOUD=serial 

[,MODE=mm] 

[,MODEL=n] 


[label] 


END 


[user-information] 



Section 8: Utilities 8-7 



ICAPRTBL 

ICAPRTBL, an independent utility: 

• Loads UCS and FCB buffers of a 321 1 . 



Job Control Statements 

Because ICAPRTBL is an independent utility, operating-system job control state- 
ments are not used. 
Control Statements 



JOB 


indicates the beginning of an ICAPRTBL job. 


DFN 


defines the address of the 321 1 . 


UCS 


contains an image of the characters to be loaded into the UCS buffer. 


FCB 


defines the image to be loaded into the FCB. 


END 


indicates the end of an ICAPRTBL job. 



Name 


Operation 


Operands 


[label] 


JOB 


[user-information] 




DFN 


ADDR=*uu,FOLD=fYl 


[ucsname] 


UCS 


ucs-image 


[fcbname] 


FCB 


,LNCH=((l,c)[,(l,c)...]) 
,FORMEND=x 


[label] 


END 


[user-information] 



ICAPRTBL Wait-State Codes 



Code 


Meaning 




Code 


Meaning . 


B01 


Visually check the train 


mage 


B12 


Reader not ready . 




printed on the 3211 . 




B13 


Reader unit check (display low main 


B02 


Missing control card or control 




storage location 2 through 7 for sense 




card out of order. 






information). 


B03 


Incorrect JOB statement. 




B14 


Reader channel error. 


B04 


Incorrect DFN statement. 




B15 


No device end on reader. 


B05 


Incorrect UCS statement. 




B19 


Printer not online. 


B06 


Incorrect FCB statement. 




BIB 


Printer unit check (display low main 


B07 


Incorrect END statement. 






storage location 2 through 7 for sense 


BOA 


External interrupt. 






information) . 


BOB 


Program check interrupt. 




B1C 


Printer channel error. 


BOC 


Machine check interrupt. 




BID' 


No device end on printer. 


Bll 


" Reader not online. 









8-8 0S/VS1 Programmer's Reference Digest 



IEBCOMPR 

IEBCOMPR, a data set utility: 

o Compares partitioned data sets. 
• Compares sequential data sets. 



00 - successful completion. 

08 - unequal comparison - processing continues. 
12 - unrecoverable error - job step terminated. 
16 - a user routine passed a return code of 16 to IEBCOMPR - job 
step is terminated. 



Job Control Statements 



//name JOB 

// EXEC 

//SYSPRINT DD 

//SYSUT1 DD 

//SYSUT2 DD 

//SYSIN DD 



PGM=IEBCOMPR 

data set definition (output messages) 
data set definition (input data set) 
data set definition (input data set) 

| DUMMY \ 

"IEBCOMPR control statements" 



/* 



Note - If the input is sequential and no user exits are provided, the DUMMY 
parameter for the SYSIN DD statement is used. In this case, no utility 
control statements are required. 



Control Statements 



COMPARE 


indicates the organization of a data set. 


EXITS 


identifies the user exit routines to be used. 


LABELS 


indicates whether user labels are to be treated as data. 





Name 


Operation 


Operands 




[label] 


COMPARE 


TYPORG= j PS ( 
|PO( 


1 


[label] 


EXITS ] 


[INHDR=routinename] 
[1 NTLR=routinename] 
[ERROR=routinename] 
[PRECOMP=routinename] 




[label] 


LABELS 


DATA= (YES ) 
) NO ( 
(ALL ( 
V ONLY J 



| ' If you code more than one operand, separate them with commas. 



Section 8: Utilities 8-9 



IEBCOPY 

IEBCOPY, a data set utility: 

• Compress-in-place, a partitioned data set. 

• Converts to partitioned, a sequential data set. 
I • Converts to sequential, a partitioned data set. 

• Copies a partitioned data set. 

• Copies selected members. 

• Excludes a partitioned data set member from a copy operation. 

• Expands a partitioned data set. 

• Lists the number of unused directory blocks or tracks. 

• Loads a previously unloaded partitioned data set. 

• Merges partitioned data sets. 

• Reb locks a partitioned data set. 

I • Renames a partitioned data set member. 

• Replaces records or selected members in a partitioned data set. 

• Unloads a partitioned data set. 

Return Codes 

00 - indicates successful completion. 

04 - indicates a condition from which recovery may be possible. 

08 - indicates an unrecoverable error. The job step is terminated. 



Job Control Statements 



//name JOB 




//name EXEC 


PGM=IEBCOPY[,PARM='SIZE=nnnnnnnn[K]'] 


//SYSPRINT DD 


data set definition (output message) 


//INPUT DD 


data set definition (input data set) 


//OUTPUT DD 


data set definition (output data set) 


//SYSUT3 DD 


data set definition (spill data set - optional) 


//SYSUT4 DD 


data set definition (spill data set - optional) 


//SYSIN DD 


* 


"IEBCOPY control statements" 
/* 


The optional PARM in 


brmarion in the EXEC statement is used to define the number 


of bytes used as a buffer. The nnnnnnnn can be replaced by one to eight digits. 


The K causes the nnnnnnnn to be multiplied by 1024. 



Control Statements 



indicates the beginning of a copy operation. 



specifies which members in the input data set are to be copied. 



specifies members in the input data set to be excluded from the 
copy step. 



8-10 OS/VS1 Programmer's Reference Digest 



I EBCOPY (cont'd) 

Format 





Name 


Operation 


Operands 




[label] 


COPY 


OUTDD=ddname 

[,INDD=fddnamel[,ddname2]... Y 
<ddname1[,ddname2] [, (ddname2,R)]. . . > 
(((ddnamel,R)[,ddname2]...) ) 

[,LIST=NO] 


* 




*The INDD parameter may appear on a separate card; 
if this option is selected, the INDD parameter is not 
preceded by a comma (,). 




[label] 


SELECT 


/name. . . \ 
MEMBER=)[(] (name,,R)...[)] I [,...] 
(.[(] namejnewnamel^] . . .[)] ) 




[label] 


EXCLUDE 


MEMBER=[(]membemamel [,membername2]. . . [)] 



Section 8: Utilities 8-11 



IEBDG 

IfcBDG, a data set utility: 

• Converts to sequential, an indexed sequential data set. 

• Copies or creates members. 

• Creates a sequential output data set. 

• Generates test data. 



Return Codes 

00 - successful completion. 

04 - a user routine returned a code of 16 to the IEBDG program. The job 

step is terminated at the user's request. 
08 - an error occurred while processing a set of utility control statements. No data is 

generated following the error. Processing continues normally with the next set of 

utility control statements, if any. 
12 - indicates that an error occurred while processing an input or output data set. The 

job step is terminated. 
16 - an error occurred from which recovery is not possible. The job step is terminated. 



Job Control Statements 



//name 


JOB 


// 


EXEC 


//SYSPRINT 


DD 


//SEQIN 


DD 


//PARIN 


DD 


//SEQOUT 


DD 


//PAROUT 


DD 


//SYS IN 


DD 



parameters 

PGM=IEBDG[,PARM=UNECNT=nnnn] 

data set definition (output message) 

data set definition (sequential input - optional) 

data set definition (partitioned input - optional) 

data set definition (sequential output - optional) 

data set definition (partitioned output - optional) 

(DATA/ 

"IEBDG control statements" 



/* 



The optional PARM information in the EXEC statement is used to specify the 
number of lines to be printed between headings in the message data set. The 
nnnn is a four-digit decimal number that specifies the number of lines (0000 to 
9999) to be printed per page of output listing. 

The DSNAME parameter for the PARIN and PAROUT DD statements can be 
coded as DSNAME=setname (membemame). 



Control Statements 



DSD 


specifies the ddnames of input and output data sets. 


FD 


defines the contents and lengths of fields to be used in creating 
output records. 


CREATE 


defines the contents of output records. 


REPEAT 


specifies the number of times a CREATE statement or grc jp of 
CREATE statements are to be used in generating output records. 


END 


marks the end of a set of IEBDG utility control statements. 



8-12 OS/VS1 Programmer's Reference Digest 



IEBDG (cont'd) 

IBM Supplied Patterns 



Type 


Expressed in 
Hexadecimal 


Expressed in 
Printable Characters 


Alphameric 


CI C2...E9F0...F9 


ABC...Z 0...9 


Alphabetic 


CI C2...E9 


ABC...Z 


Zoned Decimal 


F0F0...F0F1 


00... 01 


Packed Decimal 


0000. ..001C 
(Positive pafhern) 
0000... 001 D 
(Negative pattern) 


Not applicable 


Binary Number 


00.. .01 

(Positive pattern) 
FF...FF 
(Negative pattern) 


Not applicable 


Collating Sequence 


40... F9 


b/.<(+l&l$*)n-/,% >?:'<§>•=" 
A...Z 0...9 


Randon Number 


Random hexadecimal 
digits 


Not applicable 


Note: A packed-decimal or binary number is right-aligned in the defined field. 



Name 


Operation 


Operands 


[label] 


DSD 


OUTPUT=(ddname) 
[,INPUT=(ddname,...)] 


[label] 


FD 


NAME=name 

, LENGTH=length-in-bytes 

[,STARTLOC=srarting-byte-location] 

('character 1 ' \ 
[,FILL=< >] 
;(X'2-hexadecimal-digits') 
[, FORMAT=pattern*[, CHARACTER=characterH 

('character-string 1 ) 
[ / PICTURE=lengthX P'decimal-number' > ] 

(B'decimal-number' ' 
[,SIGN=sign] 
[,ACTION=action]** 

[, 1 NDEX=number[, CYCLE=number] [, RANGE=number]] 
[,INPUT=ddname] 
[, FROMLOC=number] 


* specifies IBM supplied patterns - see table below. 

"specifies how the contents of a defined field are to be altered - see table below. 


[label] 


CREATE ] 


'[QUANTITY=number] 

( 'character' ) 
[FILL=] >] 
( X'2-hexadecimal-digits' ) 
/ ddname \ 
[INPUT={ \] 
(SYSIN[(cccc)]) 
J < 'character-string' ) 
\ [PICTURE=length,startloc,< P'decimal-number' \] 
(B'decimal-number' ) 

[NAME=|(namel,riame2...) 1 J 
( (name, (COPY=namel ,name2 ...)...)) 

k _[EXIT=routinename] 


> 



1 Use at least one of the optional parameters. If you code more than 
one operand, separate them v 



Section 8: Utilities 8-13 



IEBDG (cont'd) 

Format (cont'd) 



[label] 


REPEAT 


QUANTITY=number[, CREATE=number] 


[label] 


END 





FORMATS N» 


alphameric. 


ACTION=SL — shift left. 


FORMAT=Z0 — 


zoned decimal. 


ACTION=SR— shift right. 


FORMAT=PD ~ 


packed decimal. 


ACTIONAL — truncate left. 


FORMAT=CO — 


collating sequence. 


ACTION=TR — truncate right. 


FORMAT=BI — 


binary. 


ACTION=RO«roll. 


FORMAT=AL ~ 


alphabetic. 


ACTION=WV —wave. 


FORMAT=RA ~ 


random binary number. 


ACTION=FX — fixed. 
ACTION=RP— ripple. 



8-14 OS/VS1 Programmer's Reference Digest 



IEBEDIT 

IEBEDIT, a data set utility: 

• Copies job steps. 

• Creates an output job stream. 

• Edits and copies a job stream. 

Return Codes 

00 - successful completion. 

04 - indicates that an error occurred. The output data set may not be usable 

as a job stream. Processing continues. 
08 - indicates that an unrecoverable error occurred while attempting to process 

the input, output, or control data set. The job step is terminated. 

Job Control Statements 



//name JOB 
// EXEC 
//SYSPRINT DD 
//SYSUTl DD 
//SYSUT2 DD 
//SYS IN DD 


PGM=IEBEDIT 

data set definition (output message) 
data set definition (input data set) 
data set definition (output data set) 


"IEBEDIT 


control statements" 


/* 





Control Statements 




indicates which step or steps of a specified job in the input 
data set are to be included in the output data set. Any number 
of EDIT statements can be included in an operation, thus including 
selected jobs in the output data set. 



Name 


Operation 


Operands 


[label] 


EDIT 1 


[START=jobname] 

f (POSITION)] 
TYPE=< INCLUDE > 

L (exclude )j 










TSTEPNAME^ (I name If | name 
[_ \lname-namej L , I name- 


namejj , 


...)] 






[NOPRINT] 







I ' If you code more than one operand, separate them with commas. 



Section 8: Utilities 8-15 



IEBGENER 

IEBGENER, a data set utility: 

. • Changes logical record length. 

• Converts to partitioned, sequential data sets. 

• Copies members. 

• Copies sequential data sets. 

• Edits and converts to partitioned, a sequential data set. 

• Edits and copies a sequential data set. 
Expands a sequential data set. 

• Prints a sequential data set. 

• Reblocks a sequential data set. 



Return Codes 

00- successful completion. 

04- probable successful completion. A warning to the user is written. 

08 - processing was terminated after the user requested processing of 

user header labels only. 
12 - an unrecoverable error has occurred. The job step is terminated. 
16- a user routine has passed a return code of 16 to the IEBGENER 

program. The job step is terminated. 



Job Control Statements 



//name JOB 


parameters 


// EXEC 


PGM=1EBGENER 


//SYSPRINT DD 


data set definition (output message) 


//SYSUT1 DD 


data set definition (input data set) 


//SYSUT2 DD 


data set definition (output data set) 


//SYS IN DD 


parameters 


"IEBGENER control statements (when required)" 


/* 





Control Statements 



GENERATE 


used to indicate the number of member names and alias 
names, record identifiers, literals, and editing information 
contained in the control data set. 


EXITS 


used to indicate that user routines are provided. 


LABELS 


used to specify user- label processing. 


MEMBER 


used to specify the member name and alias of member of a 
partitioned data set to be created. 


RECORD 


used to define a record group to be processed and to 
supply editing information. 



8-16 OS/VS1 Programmer's Reference Digest 



IEBGENER (cont'd) 

Conversion Table 



Code 


Conversion 


Output length 
(input length = L) 


PZ 


Packed to unpacked decimal mode 


2L-1 


ZP 


Unpacked to packed decimal mode 


(L/2) + C* 


HE 


H-set BCD to EBCDIC mode 


L 


* If L is odd, C is 1/2; if L is even, C is 1 . 


Note: PZ type (packed to unpacked) conversion is impossible for packed 
decimal records longer than 16K bytes. For ZP type (unpacked to packed 
conversion, the normal 32K byte maximum applies. 

If no conversion is specified, the field is moved to the output area without 
change. 

When the ZP parameter is specified, the conversion is performed in place. 
The original unpacked field is replaced by the new packed field. Therefore, 
the ZP parameter must be omitted from subsequent references to that field. 
If the field is needed in its original unpacked form, it must be referenced 
prior to the use of the ZP parameter. 



Name 


Operation 


Operands 


(label) 


GENERATE 1 


[MAXNAME = n] 
[MAXFLDS = n] 
[MAXGPS = n] 
(MAXLITS = n] 


[label] 


EXITS ' 


[INHDR = routinename] 
[OUTHDR = routinename] 
[ INTLR = routinename] 
|OUTTLR = routinename] 
(KEY -routinename] 
[DATA = routinename] 
[iOERROR= routinename] 
(TOTAL = (routinename, size)] 


(label] 


LABELS 


DATA = (YES ) 
1NO f 
<ALL > 

/onlyI 
(input; 


[label] 


MEMBER 


NAME = (namef, alias]...) 


[label] 


RECORD 




" IDENT = (length, 'name', input- location) 

FIELD = ([length], [input- location-or- 'literal'], [conversion], 
[output- location]). . . 

.LABELS = n 





I I If you code more than one operand, separate them with commas. 



Section 8: Utilities 8-17 



IEBISAM 

IEBISAM, a data set utility: 

• Converts to sequential, a partitioned data set. 

• Copies an indexed sequential data set. 

• Loads an indexed sequential data set. 

• Unloads an indexed sequential data set. 

Return Codes 

00 - successful completion. 

04 - a return code of 04 or 12 was passed to the IEBISAM program by a user routine. 

08 - the program terminated operation because an error condition was encountered 

during processing. 
12 - a return code other than 00, 04, 08, or 12 was passed from a user routine to 

the IEBISAM program. The [ob step is terminated. 
16- the program terminated operation because an error condition was encountered 

during processing. 



Job Control Statements 



//name JOB 




7/ EXEC 


PGM=IEBISAM,PARM=(cOPY ) 




1UNLOAD / 




<LOAD > 




JPRINTL \ 




(/PRINTL[,N1 [,EXIT=routinename]'J 


//SYSPRINT DD 


data set definition (output messages) 


//SYSUT1 DD 


data set definition (input data set) 


//SYSUT2 DD 
/* 


data set definition (output data set) 


The PARM parameter or 


the EXEC statement is used to control the execution of 


IEBISAM. 





Control Statements 

The IEBISAM program is controlled by job control statements. 
No utility control statements are required. 



8-18 OS/VS1 Programmer's Reference Digest 



IEBPTPCH 

IEBPTPCH, a data set utility: 

• Edits and prints a sequential data set. 

• Edits and punches a sequential data set. 

• Prints a sequential data set. 

• Prints partitioned data sets. 

• Prints selected records. 

• Punches a partitioned data set member. 

• Punches a sequential data set. 

• Punches selected records. 



Return Codes 

00 - indicates successful completion, 

04 - indicates that either a physical sequential data set is empty or a 

partitioned data set has no members. 
08 - indicates that a member specified for printing does not exist in the 

input data set. Processing continues with the next member. 
12 - indicates that an unrecoverable error occurred or that a user routine 

passed a return code of 12 to IEBPTPCH. The job step is terminated. 
16 - indicates that a user routine passed a return code of 16 to IEBPTPCH. 

The job step is terminated. 
Job Control Statements 



//name JOB 
// EXEC 
//SYSPRINT DD 
//SYSUTl DD 
//SYSUT2 DD 
//SYS IN DD 


PGM=IEBPTPCH 

data set definition (output message) 
data set definition (input data set) 
data set definition (output data set) 


"IEBPTPCH control statements" 


/* 





Control Statements 



PRINT 

or 
PUNCH 


specifies that the data is to be either printed or punched. 


TITLE 


specifies that a title is to precede the printed or punched data. 


EXITS 


specifies that user routines are provided. 


MEMBER 


specifies that the input is a partitioned data set and that a 
selected member is to be printed or punched. 


RECORD 


specifies whether editing is to be performed, that is, records 
are to be printed or punched to non-standard specifications. 


LABELS 


specifies whether user labels are to be treated as data. 



Section 8: Utilities 8-19 



IEBPTPCH (cont'd) 

Format 



Name 


Operation 


Operands 


[label] 


PRINT ! 
PUNCH 


[PREFORM=A 1 

Lpreform=mJ 
[typorg=ps 1 
Ityporg=poJ 

[TOTCONV=XE] Applicable to a PRINT or 

LTOTCONV=PZj PUNCH operation. 

[CNTROL=n] 

[STRTAFT=n] 

[STOPAFT=n] 

[SKIP=n] 

[MAXNAME=n] 

[MAXFLDS=n] 

[MAXGPS=n] 

[MAXLITS=n] 


[INITPG=n] Applicable only to a PRINT 
[MAXLINE=n] operation. 


[CDSEQ=n] Applicable only to a PUNCH 
[CDINCR=n] operation. 


[label] 


TITLE 


ITEM=('title , [ / output-locat;on]) [,ITEM...] 


[label] 


EXITS 1 


[INHDR=routinename] 
[1 NTLR=routinename] 
[1 NREC=routinename] 
[OUTREC=routinename] 


[label] 


MEMBER 


( NAME=membername | 
lNAME=aliasname J 


[label] 


RECORD ] 


[IDENT=(length / 'name', input-location)] 
fFIELD^Iength, [input-location], [conversion],"] 
|_ [output-location]) [, FIELD*. . .] J 


[label] 


LABELS 


DATA= ( YES ) 
) NO ( 
/ALL ( 
IONLyJ 



Conversion Table 



K 



Code 


Conversion 


Output Length 
(Where L is the Input Length) 


PZ 


Packed to unpacked decimal 
mode 


2L-1 


XE 


Alphameric to hexadecimal 
representation 


2L 



you code more than one operand, separate them with commas. 



8-20 OS/VS1 Programmer's Reference Digest 



IEBTCRIN 

IEBTCRIN, a data set utility: 

© Constructs records from MTST and MTDI input. 
© Edits MTDI input. 
o Reads Tape Cartridge Reader input. 



Return Codes 

00 - normal termination. 

04 - wurning message issued; execution permitted. Conditions leading to issuance 
of this code are: (1) SYSPRINT, SYSIN, SYSUT2, or SYSUT3 DD statements 
missing and (2) DCB parameters missing in SYSUT2 or SYSUT3 DD statements. 

12 - Diagnostic error message issued; execution terminated. Conditions leading to 
issuance of this code are: (1) SYSUT1 DD statement missing, (2) conflicting 
DCB parameters in DD statements, and (3) invalid or conflicting utility control 
statements. 

16 - Terminal error message issued; execution terminated. Conditions leading to 
issuance of this code are: (1) permanent input/output errors (not including 
data checks on the TCR), (2) unsuccessful opening of data sets, (3) requests 
for termination by user exit routine, (4) insufficient storage available for 
execution, and (5) user exit routine not found. 



Job Control Statements 



//name 


JOB 




// 


EXEC 


PGM=IEBTCRIN 


//SYSPRINT 


DD 


data set reference (output messages) 


//SYSUT1 


DD 


data set definition (input data set) 


//SYSUT2 


DD 


data set definition (output data set-valid records) 


//SYSUT3 


DD 


data set definition (output data set-error records) 


//SYSIN 


DD 


* 




IEBTCRIN control statements" 


/* 







Special Purpose Codes 



MTDI Codes 










X'00' (LZ) 


X'lE' 


(VOK) 


X'74' 


(P4) 


X'll' (DUP) 


X'3C 


(RM) 


X'75' 


(P5) 


X'12' (LZS) 


X'7V 


(PI) 


X'76' 


(P6) 


X'18' (CAN) 


X'72' 


(P2) 


X'77' 


(P7) 


X'lD' (GS) 


X'73' 


(P3) 


XV8' 


(P8) 


MTST Codes 










X'10' (cr) 


X'14' 


(CR) 


X'51' 


(as) 


X'll' (sw) 


X'15' 


(SW) 


X'55' 


(AS) 


X'13' (fd) 


X'17' 


(FD) 


X'80' 
X'8r 


(src) 
hrough X'FF' 



The special purpose codes listed are used by IEBTCRIN when constructing 
records. Use of these codes causes a message to be issued and the utility to 
be terminated. 



Section 8: Utilities 8-21 



IEBTCRIN (cont'd) 



"1 


1 

X 

1 












MTDI Codes from TCR 












s 


00 


01 


10 


11 


1 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


a 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


0000 





LZ 








SP 


& 


- 

















082 





0001 


1 




DUP 










/ 


PI 










A 


J 




1 


0010 


2 




LZS 












P2 










B 


K 


S 


2 


0011 


3 
















P3 










C 


L 


T 


3 


0100 


4 
















P4 










D 


M 


U 


4 


0101 


5 
















P5 










E 


N 


V 


5 


0110 


6 
















P6 










F 


O 


W 


6 


0111 


7 
















P7 










G 


P 


X 


7 


1000 


8 




CAN 












P8 










H 


Q 


Y 


8 


1001 


9 




ED 






















1 


R 


Z 


$ 


1010 


A 










? 


1 






















1011 


B 












$ 


' 


§ 


















1100 


C 








RM 


< 


• 


% 


@ 


















1101 


D 




GS 






( 


) 


- 


/ 


















1110 


E 




VOK 






+ 


; 


> 


= - 


















1111 


F 










1 


- 


? 


" 



















Bit Positions 0,1 
Bit Positions 2,3 
First Hexadecimal Digit 



Special Control: 
LZ = Left zero fill 
DUP = Duplicate 
LZS = Left zero start 
ED = End Data 
GS = Group Separatof 



Start of Record (SOR): 
PI = Program level 1 
P2 = Program level 2 
P3 = Program level 3 
P4 =■ Program level 4 
P5 = Program level 5 
P6 = Program level 6 
P7 = Program level 7 
P8 =• Program level 8 
CAN = Cancel 

End of Record (EOR): 
RM = Record mark 
VOK= Verify OK 



This figure represents the character set and control 
codes as read from an MTDI created cartridge. 



8-22 OS/VS1 Programmer's Reference Digest 



iEBTCRIN (cont'd) 



MTST Codes from TCR 



i 1 


00 


01 


10 


11 


£ 1 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


2 Ji 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


0000 





z 


cr 


5 





! 


tab 




s 


sr= 
















0C01 


1 


_2J 


sw 


6 


9 




OS 


i 


w 


















0010 


2 


t 




e 


h 


j 


SP 


P 


y 


















0011 


3 


n 


fd 


k 


b 


= 




q 


- 


















0100 


4 


Z 


CR 


% 


) 




TAB 




s 


SRC 
















0101 


5 


@ 


SW 


c 


( 




AS 


I 


w 


















0110 


6 


T 




E- 


H 


J 


SP 


p 


Y 


















01 11 


7 


N 


FD 


K 


S 


- 




Q 


- 


















1000 


8 


1 




7 


4 


m 


bsp 


r 


o 


















1001 


9 


3 


st 


8 




^ 




a 




















1010 


A 


x 




d 


1 


g 




; 


/ 


















1011 


3 


o 




c 




f 


stx 


, 




















1100 


C 


* 




& 


$ 


M 


BSP 


R 


O 


















1101 


D 


i 


ST 


* 




V 




A 




















1110 


E 


X 







L 


G 






? 


















nn 


F 


u 




c 




F 


STX 























Bit. Positions 0,1 
Bit Positions 2,3 
First Hexadecimal Digit 



cr and CR = Carrier 

sw and SW = Switch code 
fd and FD - Feed code 
st and ST = stop code 
tab and TAB = Tab code 
as and AS = Automatic 

sp and SP = Space 
bsp and BSP = Backspace 
stx and STX = Stop transfer 
src and SRC = Search 



Section 8: Utilities 8-23 



IEBTCRIN (cont't) 



after Translation by II 
h TRANS = STDCL 



^ 


"8 

X 

1 


00 


01 


10 


11 


1 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


s 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


0000 













SP 


& 


- 





















0001 


1 














/ 




a 


i 






A 


J 




1 


0010 


2 






STX 












b 


k 


S 




B 


K 


S 


2 


0011 


3 


















c 


l 


t 




C 


L 


T 


3 


0100 


4 


















d 


m 


u 




D 


M 


U 


4 


0101 


5 


TAB 
















e 


n 


v 




E 


N 


V 


5 


0110 


6 




BSP 














f 


o 


w 




F 





w 


6 


0111 


7 


















g 


P 


'x 




G 


P 


X 


7 


1000 


8 


















h 


q 


y 




H 


Q 


Y 


8 


1001 


9 


















I 


r 


z 




1 


R 


z 


9 


1010 


A 










<? 


! 






















1011 


B 












$ 


, 


# 


















1100 


C 












* 


% 


@ 


















1101 


D 


CR 








( 


) 




' 


















1110 


E 




SRC 






+ 


; 




= 




± 














mi 


F 














? 





















The STDUC option permits translating 
both lowercase and uppercase alphabetic 
characters to uppercase. 



Bit Positions 0,1 
Bit Positions 2,3 
First Hexadecimal Digit 



TAB = Tab code 
CR = Carrier return 
BSP = Backspace 
SRC = Search 
STX = Stop transfer 
SP = Space 



8-24 OS/VS1 Programmer's Reference Digest 



IEBTCRIN (cont'd) 

Control Statements 



specifies whether MTDI or MTST input is to be processed and the 
type of processing to be performed. 



specifies any exit routines provided by the user. 



Name 


Operation 


Operands 


Comments 


[label] 


TCRGEN 1 




("STDUC \~ 

TRANsJ STDLC 

jname ( 

'notranL 

edit=^editr > 
(noedit)J 

r {nochkH 

[vERCH^j VOKCHK y 
[MINLN=n] 
[MAXLN=n] 

[ REPLACE= Oj 

>RROPT=/NORMALn 
iNOERR /J 


valid only with TYPE=MTST 
specification. 

Valid only with TYPE=MTDI 
specification. 

Valid only with TYPE=MTDI and either 
an EDIT=EDITD or EDIT=EDITR 
specification. 

Valid only with TYPE=MTDI and either 
an EDIT=EDITD or EDIT=EDITR 
specification. 

Defaults 20 

This operand is ignored if a user routine 
is specified for the ERROR operand in the 
EXITS utility control statement. 


[label] 


EXITS 1 


[ERROR=routine name] 


This exit is taken just prior to 
passing an error record to the 
error output data set (SYSUT3) 


[OUTREC=routine name] 


This exit is taken just prior to 
passing a record to the normal 
output data set (SYSUT2). 


[OUTHDR2=routine ncme] 


This exit is taken during the 
opening of the SYSUT2 data set. 


[OUTHDR3=routine name] 


This exit is taken during the 
opening of the SYSUT3 data set. 


[OUTTLR2=routine name] 


This exit is taken during the 
closing of the SYSUT2 data set. 


[OUTTLR3=routine name] 


This exit is taken during the 
closing of the SYSUT3 data set. 



j code more than one operand, separate thei 



Section 8: Utilities 8-25 



IEBUPDTE 

IEBUPDTE, a data set utility: 

• Changes data set organization. 

• Converts to partitioned, sequential data sets. 

o Converts to sequential, a partitioned data set. 

• Copies members. 

• Copies sequential data sets. 

• Creates a library of partitioned members. 

• Deletes records in a partitioned data set. 

• Edits and converts to partitioned, a sequential data set. 

• Edits and copies a sequential data set. 

• Enters a procedure into a procedure library. 

• Includes changes to members or sequential data sets. 

• Inserts records into a partitioned data set. 

• Modifies a partitioned or sequential data set, 

• Numbers records in a new member or in a partitioned data set. 

• Prints a sequential data set. 

• Reblocks a sequential data set. 

• Renumbers logical records. 

e Replaces logical records, members, records in a member, or 
records in a partitioned data set. 

• Updates in place, a partitioned data set. 



Return Codes 

00 - indicates successful completion. 

04 -.indicates that a control statement is coded incorrectly or used erroneously. 

If either the input or output is sequential, the job step is terminated. If 

both are partitioned, the program continues processing with the next 

function to be performed. 
12 - indicates an unrecoverable error. The job step is terminated. 
16- indicates that a label-processing code of 16 was received from a user's 

label-processing routine. The job step is terminated. 



Job Control Statements 



//name 


JOB 




// 


EXEC 


PGM=IEBUPDTE,PARM=(JNEW j[,inhdr][,intlr]) 
/MODJ 


//SYSPRINT 


DD 


data set definition (output messages) 


//SYSUT1 


DD 


data set definition (input data set) 


//SYSUT2 


DD 


data set definition (output data set) 


//SYS IN 


DD 


j data[ 


./ 


IEBUPDTE control statements" 


(optional date 


or label statements) 


/* 







8-26 OS/VS1 Programmer's Reference Digest 



IEBUPDTE (cont'd) 

Function Statements 

A function statement is used to initiate the utility operation. At least one function 
statement must be provided for each member or data set to be processed. A function 
statement contains: 



1 -2 


Name 


Operation 


Operands 


•/ 


[label] 


/ADD 1 , 
1REPL 1 
) CHANGE I 
' REPRO ' 


[LIST-ALL] 

[SEQFLD=ddl] 

[NEW=PO] Applicable to partitioned 

[NEW = PS] or sequential organization. 

[MEMBER=cccccccc] 

[COLUMN=dd] 

[UPDATE = INPLACE] 


[INHDR=cccccccc] 

[lNTLR=cccccccc] Applicable to sequential 

[OUTHDR-cccccccc] organization only. 

[OUTTLR=cccccccc] 

[ TOTAL=(routinename,size)] 


[NAME=cccccccc] 

[LEVEL=hh] Applicable to partitioned 

[SOURCE = x] organization only . 

[SSI=hhhhhhhh] 



' If you code more than one operand, separate them with commas; 
Detail Statements 

A detail statement is used with a function statement for certain applications, such c 
deleting or renumbering selected logical records. A detail statement contains: 



1-2 


Name 


Operation 


Operands 


./ 


[label] 


(number 1 ) 

|DELETE j 


[SEQ1=cccccccc] Used with the NUMBER or 
[SEQ2=cccccccc] DELETE statement. 


[SEQ1=ALL] 

[NEWl-cccccccc] Used only with the NUMBER 

[INCR=cccccccc] statement. 

[INSERT=YES] 



1 If you code more than 
Data Statement 



operand, separate them with commas. 



A Data Statement is used with a Function statement, or with a Function statement and 
a Detail statement. It contains a logical record used as replacement data for an exist- 
ing logical record, or new data to be incorporated in the output master data set. 



Label Statement 



The LABEL statement indicates that the following data statements are to be treated as 
user labels. These new user labels are placed on the output data set. The next Function 
statement indicates to IEBUPDTE that the last label data statement of the group has been 
read. The label statement contains: 



1-2 


Name 


Operation 


• / 


[label] 


LABEL 



Section 8: Utilities 8-27 



IEBUPDTE (cont'd) 

ALIAS Statement 



An ALIAS statement creates or retains an alias in an output (partitioned) master directory. 
The ALIAS statement can be used with any of the function statements. Multiple alias 
names can be assigned to each member. The ALIAS statement contains: 



1-2 


Name 


Operation 


Operand 


./ 


[label] 


ALIAS 


NAME=cccccccc 



ENDUP Statement 

An ENDUP statement can be used to indicate the end of SYSIN input to this job step. 
It serves as an end-of-data indication if there is no other indication. The ENDUP 
statement follows the last group of SYSIN control statements and contains: 



1-2 


Name 


Operation 


•/ 


[label] 


ENDUP 



1-28 0S/VS1 Programmer's Reference Digest 



I EH ATLAS 

IEHATLAS, a system utility: 

o Analyzes tracks on direct access. 

a Assigns alternate tracks to a direct access volume. 

e Gets alternate tracks on a direct access volume. 

e Recovers data from defective tracks on direct access volumes. 

o Replaces data on an alternate track. 



Job Control Statements 



//name 


JOB 




// 


EXEC 


PGM=IEHATLAS 


//SYSPRINT 


DD 


data set reference (output messages) 


//SYSUT1 


DD 


data set definition (data set that contains the 
bad record) 


//SYS IN 


DD 


* 




IEHATLAS control statements" 


/* 







Control Statements 

The utility control statement consists of eithei 



TRACK=bbbbcccchhhhrrkkdddd[S] 



VTOC=bbbbcccchhhhrrkkdddd 



TRACK= 

specifies that an alternate track is to be assigned for a track that does 
not contain VTOC records. 

VTOC= 

specifies that an alternate track is to be assigned for a track that contains 
VTOC records. 



Section 8: Utilities 8-29 



IEHDASDR 

IEHDASDR, a system utility: 

4 Analyzes tracks on direct access. 

• Assigns alternate tracks to a direct access volume. 

• Changes the volume serial number of a direct access volume. 

• Copies a direct access volume. 

• Copies dumped data from tape to direct access. 

• Dumps a direct access volume. 

• Gets alternate tracks on a direct access volume. 

• Initializes a direct access volume. 

• Lists the contents of a direct access volume on a system 
output device. 

• Restores a dumped direct access volume from tape. 

• Writes I PL records and a program on a direct access volume. 



Return Codes 

00- indicates successful completion. 

04 - indicates that an unusual condition was encountered; 
however, the overall result is successful. A warning 
message is issued. 

08 - indicates that a specified operation did not complete success- 
fully. An attempt is made to perform any additional operations. 

16 - indicates that either an error occurred upon invoking IEHDASDR, 
or IEHDASDR was unable to open the input or message data set. 
The job step is terminated. 



Job Control Statements 



//name 
// 



//SYS PRINT 
//anyname 
//tapename 
//SYS IN 



JOB 
PGMHEHDASDR 



/* 



DD 
DD 
DD 
DD 
IEHDASDR 



~,PARM='N=n' 
,PARM='LINECNT=xx' 
_, PARM='LI NECNT=xx, N=n^ 
data set definition (output messages) 
data set definition (direct access device) 
data set definition (magnetic tape unit) 

control statements" 



The optional PARM information is used by the program to control line density 
on output listings, and to indicate the maximum number of operations of the 
same type that can be performed concurrently in the job step. 

LINECNT=xx 

specifies the number of lines per page in the listing of the SYSPRINT 
data set. The number xx is a 2— digit decimal number ranging from 
01 to 99. 



N=n 



specifies a decimal number from 1 to 6. The number represents the 
maximum number of like functions that can be performed concurrently 
by the IEHDASDR program. 



Control Statements 



ANALYZE 


used to analyze the recording surface to test for defective tracks, 
assign alternates for any defective tracks found, and format the 
volume to make it ready for use. 


FORMAT 


used to make a volume ready for use without performing an analysis 
of the recording surface. 


LABEL 


used to change the volume serial number of a direct access volume 
and, optionally, to update the owner field. 



8-30 OS/VS1 Programmer's Reference Digest 



IEHDASDR (cont'd) 

Control Statements (cont'd) 



GETALT 


used to assign an alternate track for a specified track. 


DUMP 


used to dump a single track, a group of tracks, or an 
entire direct access volume. 


RESTORE 


used to restore a previously dumped direct access volume 
to a direct access device. 


IPLTXT 


signals the beginning of IPL program text statements. 


PUTIPL 


specifies that IPL records and a program are to be written 
on a direct access device. 



Name 


Operation 


Operands 


[label] 


ANALYZE 


j TODD=(cuu,...) j 

| TODD=(ddname,...)l 

,VTOC=xxxxx 

,EXTENT=xxxxx 

[,NEWVOLID=serial] 

[,PLDD=ddname] 

r GTEsT im{i 

[,OWNERID=name] 
r,PURGE=(YESn 

L MJ 


[label] 


FORMAT 


TODD=(ddname, . . .) 

,VTOC=xxxxx 

,EXTENT=xxxxx 

[,NEWVOLID=serial] 

[,PLDD=ddname] 

[,OWNERID=name] 

r RGE isy] 


[label] 


LABEL 


TODD=/cuu \ 
Iddname/ 
,NEWVOLID=serial 
[,OWNERID=name] 


[label] 


GETALT 


TODD=ddname 
,TRACK=cccchhhh 


[label] 


DUMP 


FROMDD=ddname 
,TODD=(ddname,...) 
f,CPYVOLlD=JYES [1 

l \m\ 

[,BEGIN=cccchhhh] 
[,END=cccchhhh] 

[' PURGE 11I] 


[label] 


RESTORE 


TODD=(ddname,...) 

,FROMDD=ddname 

r,CPYVOLID=|YESV| 

[' PURGE lrf 


[label] 


IPLTXT 





Section 8: Utilities 8-31 



IEHDASDR (cont'd) 

Format (cont'd) 



[label] 


PUTIPL 


FROMDD=ddname 
,TODD=ddname 

E PURG Tn E o S }] 



PURGE=YES - Operator Replies 



Reply 


Meaning 


U 


All unexpired data sets on the volume can be overwritten. 
(The operation continues.) 


T 


The volume contains unexpired data sets that must not be 
overwritten. (The operation is terminated.) 



8-32 OS/VS1 Programmer's Reference Digest 



IEHINITT 

IEHINITT, a system utility: 

• Labels magnetic tape volumes. 

Return Codes 

00 - successful completion. A message data set was created. 

04 - successful completion. No message data set v/as defined by the user. 

08 - the program completed its operation but error conditions were encountered 

during processing. A message data set was created. 
12 - the program completed its operation but error conditions were encountered 

during processing. No message data set was defined by the user. 
16 - the program terminated operation because of error conditions encountered 

while attempting to read the control data set. A message data set was 

created if defined by the user. 



Job Control Statements 




//name 


JOB 




// 


EXEC 


PGM=IEHINITT[,PARM=LINECNT=nn] 


//SYS PRINT 


DD 


data set definition (sequential output) 


//anyname 


DD 


data set definition (tape unit-labeling) 


//SYS IN 


DD 


* 


/* 


'INITT control statement(s)" 


The optional PARM in 


Formation on the EXEC statement specifies the number 


of lines to be 


printed between headings in the message data set. 



Control Statements 

The IEHINITT program uses an INITT utility control statement to provide control 
information for a labeling operation. Any number of INITT utility control statements 
can be included for a given execution of the program. An identically named DD 
statement must exist for a utility control statement in the job step. 



Name 


Operation 


Operands 


label 


INITT 


SER=xxxxxx 

[,OWNER='cccccccccc[cccc]'] 
[,NUMBTAPE=n] 
J,DISP=REWIND . 
l,DISP=UNLOAD f 
[,LABTYPE=AL] 



Section 8: Utilities 8-33 



IEHIOSUP 

IEHIOSUP, a system utility: 

• Updates TTR entries in the supervisor call library. 



Return Codes 



00 - successful completion. 

12 - an unrecoverable error has occurred. The job step is terminated. 



Job Control Statements 



//name JOB 

// EXEC PGM=IEHIOSUP 

//SYSUT1 DD data set definition (object data set - SYS1 .SVCLIB) 

//SYSPRINT DD data set definition (output messages) 

/* 



Control Statements 

IEHIOSUP is executed or invoked with job control statements. No 
utility control statements are required. 



8-34 OS/VS1 Programmer's Reference Digest 



IEHLIST 

IEHLIST, a system utility: 

o Lists a volume table of contents. 

a Lists partitioned directories. 

o Lists the contents of the catalog (SYSCTLG) data set. 



Return Codes 

00 - successful completion. 

08 - due to an error condition, a specified request was ignored. 

Processing continues. 
12 - indicates that a permanent input/output error occurred. The job 

is terminated. 

16 — indicates that an unrecoverable error occurred while reading the 

data set. The job is terminated. 



Job Control Statements 



//name 


JOB 


parameters 


// 


EXEC 


PGM=IEHLIST[,PARM='LINECNT=xx'] 


//SYSPRINT 


DD 


data set definition (output message) 


//anynamel 


DD 


data set definition (permanently mounted volume) 


//anyname2 


DD 


data set definition (mountable device type) 


//SYS IN 


DD 


* 


/* 


IEHLIST control statements" 


The optional PARM information on the EXEC statement specifies the number 


of lines to be 


printed pe 


page. The value of xx is a decimal number from 01 


through 99. 







Control Statements 



LISTCTLG 


used to request a listing of all or part of a catalog. 


LISTPDS 


used to request a directory listing of one or more partitioned 
data sets. 


LISTVTOC 


used to request a listing of all or part of a volume table of 
contents. 



Name 


Operation 


Operands 


[label] 


LISTCTLG ] 


[VOL=device=serial] 
[NODE=name] 


[label] 


LISTPDS ] 


DS NAME=(name[, name] . . . ) 

[VOL=device=serial] 

j DUMP [ 

/FORMATJ 


[label] 


LISTVTOC 1 




DUMP ( 

FORMAT \ 
DATE=dddyy] 
VOL=device=serial ] 
DSNAME=(nam8[ / name]...) 



I ' If you code moie than one operand, separate them with comma; 



Section 8: Utilities 8-35 



IEHMOVE 

IEHMOVE, a system utility: 

• Copies a catalog. 

• Copies a direct access volume. 

• Copies a partitioned data set. 

• Copies a volume of data sets. 

• Copies cataloged data sets. 

• Copies selected members. 

• Copies sequential data sets. 

• Excludes a partitioned data set member from a copy operation. 

• Loads an unloaded data set. 

• Merges partitioned data sets. 

• Moves a catalog. 

• Moves a volume of data sets. 

• Moves cataloged data sets. 

• Moves partitioned data sets. 

• Moves sequential data sets. 

• Renames moved or copied members. 

• Replaces selected members in a move or copy operation. 

• Unloads a partitioned data set. 

• Unloads a sequential data set. 

Return Codes 

00 - successful completion, 

04 - a specified function was not completely successful. Processing continues. 

08 - a condition has occurred from which recovery is possible. Processing 

continues. 
12 -an unrecoverable error has occurred. The job step is terminated. 
16 - impossible to open the SYSIN or SYSPRINT data set. 



Job Control Statements 



//nc 
// 



//SYSPRINT 

//SYSUT1 

//anyname 1 

//anyname2 

//tape 

//SYSIN 

/* 



JOB paramete 

EXEC PGM=IEHMOVE ,PARM= ('POWER=n' 

'POWER=n,LINECNT=xx'j 
>LINECNT=xx' J 

DD data set definition (output message) 

DD data set definition (work data set) 

DD data set definition (permanently mounted volume) 

DD data set definition (mountable device type) 

DD data set definition (tape volume) 

DD 
"IEHMOVE control statements" 



The optional PARM information in the EXEC statement is used to allocate 
additional work space and/or control line density on output listings. 

The POWER=n parameter is used to request that the normal amount of space 
for work area is to be increased n times. 

The LINECNT=xx parameter specifies the number of lines per page in the 
listing of the SYSPRINT data set. 



Control Statements 



MOVE DSNAME 


used to move a data set. 


COPY DSNAME 


used to copy a data set. 


MOVE DSGROUP 


used to move a group of cataloged data sets. 


COPY- DSGROUP 


used to copy a group of cataloged data sets. 


MOVE PDS 


used to move a partitioned data set. 



8-36 OS/VS1 Programmer's Reference Digest 



IEHMOVE (cont'd) 

Control Statements (cont'd) 



COPY PDS 


used to copy a partitioned data set. 


MOVE CATALOG 


used to move cataloged entries. 


COPY CATALOG 


used to copy cataloged entries. 


MOVE VOLUME 


used to move a volume of data sets. 


COPY VOLUME 


used to copy a volume of data sets. 



In addition, there are four subordinate control statements that can be used to modify 
the effect of a MOVE or COPY DSGROUP, MOVE or COPY PDS, or MOVE or COPY 
CATALOG operation. The subordinate statements and the control statements with 
which they can be combined are shown in the following table: 



Valid Combinations of Control Statements 



Utility Statement 


Subordinate Statements 


MOVE DSGROUP 

or 
COPY DSGROUP 


INCLUDE 
EXCLUDE 


MOVE PDS 

or 
COPY PDS 


INCLUDE 
EXCLUDE 
REPLACE 
SELECT 


MOVE CATALOG 

or 
COPY CATALOG 


EXCLUDE 



Name 


Operation 


Operands 


[label] 


MOVE 


DSNAME=name 

,TO=device=list 

[",FROM=device=list 1 

|_,CVOL=device=serial] 

[,UNCATLG] 

[,RENAME=name] 

[,FROMDD=ddname] 

[,TODD=ddname] 


[label] 


COPY 


DSNAME=name 

,TO=device=list 

r,FROM=device=list 1 

LcVOL=device=serial] 

[,UNCATLG] 

[,CATLG] 

[,RENAME=name] 

[,FROMDD=ddname] 

[,TODD=ddname] 


[label] 


MOVE 


DSGROUP [=name] 

,TO=device=list 

[,CVOL=device=serial] 

[, PASSWORD] 

[,UNCATLG] 

[,TODD=ddname] 



Section 8: Utilities 8-37 



I EHMOVE (cont'd) 

Format (cont'd) 



[label] COPY 


DSGROUP [=name] 

,TO=device=list 

[,CVOL=device=seriall 

[, PASSWORD] 

[,UNCATLG] 

[,CATLG] . 

[,TODD=ddname] 




[label] MOVE 


PDS=name 

,TO=device=serial 

[,FROM=device=serial] 

l,CVOL=device=serialJ 

[,EXPAND=nn] 

l,UNCATLG] 

[,RENAME=name] 

[,FROMDD=ddname] 

[,TODD=ddname] 




[label] COPY 


PDS=name 
,TO=device=serial 

L,CVOL=device=serialJ 

[,EXPAND=nn] 

[,UNCATLG] 

[,CATLG] 

[,RENAME=name] 

[,FROMDD=ddname] 

[,TODD=ddname] 




[label] MOVE 


CATALOG[=name] 

,TO=device=serial 

r,CVOL=device=5erial"| 

[,FROM=device=serialJ 

[,FROMDD=ddname] 

[,TODD=ddncme] 




[label] COPY 


CATALOG[=name] 

, TO=device=serial 

r,CVOL=device=serial] 

[,FROM=device=serialJ 

[,FROMDD=ddname] 

[,TODD=ddname] 




[label] MOVE 


VOLUME=device=serial 
,TO=device=list 
[, PASSWORD] 
[,TODD=ddname] 




[label] COPY 


VOLUME=device=serial 

,TO=device=list 

[,PASSV/ORD] 

[,CATLG] 

[,TODD=ddname] 




[label] INCLUDE 


DSNAME=name 
[,MEMBER=membername] 
[,FROM=device=lisr 1 
[ / CVOL=device=serialJ 




[label] EXCLUDE 


/ DSGROUP=name \ 
I MEMBER=membername / 




[label] SELECT 


( MEMBER=(name[,name] . . .) 

1 MEMBER=((name,newname)[,(name,newname)].. 


.,} 




[label] REPLACE 


DSNAME=ncme 
,MEMBER=membernarne 
r,FROM=device=seriall 
L,CVOL=device=serialJ 





8-38 0S/VS1 Programmer's Reference Digest 



IEHPROGM 

IEHPROGM, a system utility: 

• Adds a password . 

• Builds a generation -data -group index. 

• Builds a generation . 

• Builds an index. 

• Catalogs a data set. 

• Catalogs a generation data set. 

• Connects volumes. 

• Creates an index. 

• Deletes a password. 

• Deletes an index structure. 

• Lists a password entry . 

• Password -protects add, delete, list, or replace password operations. 
| • Releases a connected volume. 

• Renames a partitioned data set member. 

• Renames a sequential or partitioned data set. 

• Replaces a password . 

• Scratches a volume table of contents. 

• Scratches data sets. 

• Uncatalogs data sets. 

Return Codes 

00 - successful completion. 

04 - a syntax error has been found in the name field of the control statement or in the 

PARM field in the EXEC statement. Processing is continued. 
08 - a request for a specific operation has been ignored because of an invalid control 

statement or an otherwise invalid request. The operation is not performed. 
12 - an I/O error has been detected when trying to read or write from or onto 

SYSPRINT, SYSIN,or the VTOC . 
16 - an unrecoverable error has occurred. The job step is terminated. 

Job Control Statements 



//name JOB parameters r- 

// EXEC PGM=IEHPROGM ,PARM='LINECNT=; 

//SYSPRINT DD data set definition (output message) 

//anynamel DD data set definition (permanently mounted volume 

//anyname2 DD data set definition (mountable device type) 

//SYS IN DD 

"IEHPROGM control statements" 

/* 



PRINT 
NOPRINTi 



The optional PARM information on the EXEC statement is used to control the 
number of lines per page on the output listing and to suppress printing of 
utility control statements. The value xx is a 2— digit decimal number from 
01 through 99. 



Control Statements 



used to delete a data set or member from a direct access volume. 



used to change the name or alias of a data set or member residing 
on a direct access volume. 



used to generate an entry in the index of a catalog. 



used to remove an entry from the lowest level index of the catalog. 



used to create a new index in the catalog. 



used to remove a low level index from the catalog. 



Section 8: Utilities 8-39 



IEHPROGM (cont'd) 

Control Statements (cont'd) 



BLDA 


used to assign an alias previously assigned to an index at the 
highest level of the catalog. 


DLTA 


used to delete an alias previously assigned to an index at the 
highest level of the catalog. 


CONNECT 


used to place an entry into an index at the highest level of 
the catalog. 


RELEASE 


used to remove an entry from the highest level index of a 
volume. 


BLDG 


used to build an index for a generation data group and 
establish the action to be taken should the index overflow. 


ADD 


used to add a password entry into the PASSWORD data set. 


REPLACE 


used to replace information in a password entry. 


DELETEP 


used to delete an entry in the PASSWORD data set. 


LIST 


used to format and list information from a password entry. 



Name 


Operation 


Operands 


[label] 


SCRATCH 


/DSNAME=name) 
IVTOC / 
,VOL=device=list 
[, PURGE] 
[,MEMBER=name] 
I, SYS] 


[label] 


RENAME 


DSNAME=name 
/ VOL=device=list 
,NEWNAME=name 
[,MEMBER=name] 


[label] 


CATLG 


DSNAME=name 

,VOL=device=list 

[,CVOL=device=serial] 


[label] 


UNCATLG 


DSNAME=name 
[,CVOL=device=serial] 


[label] 


BLDX 


INDEX=name 
[,CVOL=device=seriol] 


[label] 


DLTX 


INDEX=name 

[ ,CVOL=device=serial] 


[label] 


BLDA 


INDEX=name 
,ALIAS=name 
[ ,CVOL=device=serial ] 


[label] 


DLTA 


ALIAS^name 
[,CVOL=device=serial] 


[label] 


CONNECT 


INDEX=name 

,VOL=device=serial 

[,CVOL=device=serialj 



8-40 OS/VS1 Programmer's Reference Digest 



I EHPROGM (cont'd) 

Format (cont'd) 



Name 


Operation 


Operands 


[label] 


RELEASE 


INDEX=name 

[ jCVOL^device^serial] 


[label] 


BLDG 


INDEX=name 

,ENTRIES=n 

[ ,CVOL=device=serial ] 

[, EMPTY] 

[, DELETE] 


[label] 


ADD 


DSNAME=name 

[ , PASWORD2=new- password ] 

[,CPASWORD=control- password] 

[,TYPE=code] 

[,VOL=dev?ce=list] 

[,DATA='user-dara'] 


[label] 


REPLACE 


DSNAME=name 

[ , PASWORD 1 =current- password ] 

[,PASWORD2= new- password] 

[,CPASWORD=conrrol- password ] 

[,TYPE=code] 

[ / VOL=device=lisr] 

f , DAT A=' user- data'] 


[label] 


DELETEP 


DSNAME=name 

[ , PASWORD l=current- passv/ord ] 

[,CPASWORD=conrrol- password ] 

[,VOL=device=list] 


[label] 


LIST 


DSNAME=name 

, PASWORD l=currenr- password 



Section 8: Utilities 



IFHSTATR 

I FHSTATR, a system utility: 

• Edits and lists error statistics by volume (ESV) records. 

Job Control Statements 



// JOB 

// EXEC PGM=I FHSTATR 

//SYSUT1 DD data set definition (input data set) 

//SYSUT2 DD data set definition (output data set) 

/* 



Control Statements 

IFHSTATR is controlled by job control statements. Utility control statements are 
not used . 



8-42 OS/VS1 Programmer's Reference Digest 



Definition of Operands 



ACTION= 


action 


specifies that the contents of a defined 
field are to be altered after the field's 
inclusion in an output record. 


ADDR= 


cuu 


specifies the channel number, c, and unit 
number, uu, of the 3211. 


ADDLABEL= 


n 


specifies the total number of additional 
labels for which space is to be allocated. 
The value can be 1 through 7. 


ALIAS= 


name 


specifies an unqualified name to be assigned 
as the alias, or specifies the unqualified name 
of the index alias to be deleted. 


BEG!N= 


cccchhhh 
nnnnn 


specifies in hexadecimal a cylinder number, 
cccc, and head number, hhhh, that identifies 
the first track to be dumped. 

specifies a one- to five-byte reltative track 
address that identifies the first track to be 
dumped. 


BYPASS^ 


YES 


specifies that no check is to be made for 
defective tracks. 


CATALOG 


[=name] 


specifies the catalog entries to be moved 
or copied. 


CATLG 




specifies that the copied data set(s) is to 
be cataloged on its receiving volume(s) 
if it is a direct access volume. If a 
catalog does not exist on the receiving 
volume, it is created. 


CDINCR= 


n 


specifies the increment to be used in 
generating sequence numbers. If 
CDINCR is omitted and CDSEQ is 
coded, 10 is assumed as an increment 
value for sequence numbering. 


CDSEQ 


n 


specifies the initial sequence number of a deck 
of punched cards. 


CHARACTER= 


character 


specifies the starting character of a field. 


CNTRL=. 


n 


specifies a control character for the output device 
that either indicates line spacing, or is used to select 
the stacker as follows: I indicates single spacing or 
first stacker; 2 indicates double spacing or second 
stacker; and 3 indicates triple spacing. 



Section 8: Utilities 8-43 



Definition of Operands (cont'd) 



COLUMN^ 


dd 


specifies, in decimal, the starting column of a data 
field within a logical record image. The field extends 
to the end of the image. Column is valid only when 
CHANGE is coded. 


CPASWORD= 


control- 
password 


specifies the control password for the data set. 


CPYVOLID= 


YES 


specifies that all receiving or restored direct access 
volumes are to be assigned the serial number of ihe 
dumped volume. 




NO 


specifies that receiving or restored volumes are to 
keep their own serial numbers. 


CVOL= 


device^ 
serial 


specifies the device type and volume serial number 
of the volume, catalog entry, or index to be operated 
upon. 


CYCLE= 


number 


specifies a number of output records that are treated 
as a group by the INDEX keyword. 


DATA= 


ALL 


specifies that user labels are to be treated as data 
regardless of any return code. 




INPUT 


specifies that user labels for the output data set are 
supplied as 80 byte input records in the data portion 
of SYSIN. 




NO 


specifies that user labels are not to be treated as data. 




ONLY 


specifies that only user header labels are to be treated 
as data. 




roufinename 


specifies the symbolic name of a routine that modifies 
the physical record before it is processed by IEBGENER. 




'user-data' 


specifies that user data is to be included in the pass- 
word entry. The user data must be in single quotes 
and must not exceed 77 characters. 




YES 


specifies that any user labels that are not rejected by 
a user's label processing routine are to be treated as 
data. 


DATE= 


dddyy 


specifies that each entry that expires before this date 
is to be flagged with an asterisk(*) in the listing. 


DELETE 




specifies that generation data sets are to be scratched 
after their entries are removed from the index. 



8-44 OS/VS1 Programmer's Reference Digest 



Definition of Operands (cont'd) 



DISP- 


REWIND 
UNLOAD 


specifies that a tape is to be rewound (but not unloaded) 
after the label has been written. 

specifies that a tape is to be unloaded after the label 
has been written. 


DSGROUP 


-name 
[-name] 


specifies a qualified name. 

specifies the cataloged data sets to be processed. 


DSNAME- 


name 
(ncme[,name]...) 


specifies the fully qualified name of the data set to be 
processed. 

specifies the fully qualified names of the data sets whose 
directories or entries are to be listed. 


DUMP 




specifies that the listing is to be in unedited, hexa- 
decimal form. 


EDIT= 


EDITD 

EDITR 
NOEDIT 


specifies that the input is to be edited and that SOR 
and EOR codes are to be deleted and not included as 
part of the output record. 

specifies that the input is to be edited and SOR and 
EOR codes are to be kept as part cf the output record. 

specifies that no editing is to be performed. 


EMPTY 




specifies that all entries be removed from the 
generation-data-group index when it overflows. 


END- 


cccchhhh 
nnnnn 


specifies, in hexadecimal, a cylinder number, cccc, 
and head number, hhhh, that identify the last track to 
be dumped. 

specifies the relative truck address of the last track 
to be dumped. 


ENTRIES= 


n 


specifies the number of entries to be contained in the 
generntion-data-group index; n must not exceed 255.- 


ERROPT- 


NORMAL 
NO ERR 


specifies that all error records are to be placed in the 
error data set (SYSUT3). 

specifies that all records (including error records) are 
placed in the normol output data set (SYSUT2). No 
records are placed in the error data set (SYSUT3). 


ERROR- 


routinename 


specifies the symbolic name of a routine that is to 
-receive control for error handling. 


EXIT- 


roufinename 


specifies the name of a user routine that is to receive 
control from IEBDG before v/riting each output record. 


EXPAND- 


nn 


specifies the number of 256-byte records (up to 99 
decimal) to be added to the directory of the specified 
partitioned data set. 


EXTENT- 


xxxxx 


specifies the length (number of tracks) of the VTOC. 
specifies the decimal length of the VTOC in tracks. 


FIELD- 


conversion 


specifies a two-byte code that indicates the type 
of conversion to be performed on this field. 



Section 8: Utilities 8-45 



Definition of Operands (cont'd) 



FIELD= 
(cont'd) 


input- 
location 


specifies the starting byte of the field to be processed. 




length 


specifies the length (in bytes) of the input field or 
literal to be processed. 




'literal' 


specifies a literal (maximum length of 40 bytes) to be 
replaced in the specified output location. 




output- 
location 


specifies the starting location of this field in the out- 
put records. 


FILL= 


'character* 


specifies an EBCDIC character to be placed in each 
byte of the defined field or output record. 




X'2 hex-digits' 


specifies two hexadecimal digits to be placed in each 
byte of the defined field or output record. 


FLAGTEST= 


NO 


specifies that the program is not to check for previously 
flagged tracks on this volume. 




YES 


specifies that each track is to be checked to see if it 
was previously flagged as defective. 


FOLD= 


N 


specifies that lower case letters are not to be printed 
as upper case letters. 




Y 


specifies that lower case letters are to be printed as 
upper case letters when the lower case print train is 
not available. 


FORMAT 




specifies that the listing is to be edited for each 
directory entry, or that a comprehensive edited 
listing is to be generated. 


FORMAT= 


pattern 


specifies an IBM-supplied pattern that is to be placed 
in the defined field. FORMAT= must not be used 
when PICTURE is used. 


FORMEND= 


X 


specifies the number of lines (max. 180) on the 
printer form. For an 11 inch form, spacing six 
lines per inch, x must be 66. 


FROM= 


device= 


specifies the volume or volumes on which the data 




list 


set currently resides, if it is not cataloged. 




deviee= 


specifies the device type and volume serial number 




serial 


of the volume to be processed. 


FROMADDR= 


cuu 


specifies channel number, c, and unit number, uu, 
of the source device. 


FROMDD= 


ddname 


specifies the ddname of the DD statement defining 
the device that contains the appropriate input data. 


FROMDEV= 


xxxx 


specifies the type of the source device, for example, 
3330 or 2400. 


FROMLOC= 


number 


specifies the location of the selected field within the 
input logical record. 


IDENT= 


input- 


specifies the starting location of the field that con- 




location 


tains the identifying name in the input records. 



8-46 OS/VS1 Programmer's Reference Digest 



Definition 


of Operands 


cont'd) 


IDENT= 
(cont'd) 


length 

'name' 


specifies the length (in bytes) of the identifying 
name of the last record of the input group to which 
the FIELD parameters or member statement applies. 
The length cannot exceed eight characters. 

specifies the exact literal that identifies the last 
record of a record group. 


INCR= 


cccccccc 


specifies the increment value used for assigning 
successive sequence numbers to new or replace- 
ment logical records, or specifies an increment 
value used fcr renumbering existing logical records. 


INDD= 


R 


specific 1 ; t'ne ddnair.e which is indicated on a DD 
stute.-nant of an input data set. 

specifics that all members to be copied or loaded 
from this input data set are to replace any identi- 
cally named members on the output partitioned 
data set. 


!NDEX= 


name 
number 


specifies the qualified name of the index to be 
processed, or specifies the unqualified index name 
to be acted upon. 

specifies a number to be added to this field when- 
ever a specified number of records have been 
written. 


INHDR= 


cccccccc 
roufinename 


specifies the symbolic name of a user routine that 
handles any user input (SYSUT1) header labels. 

specifies the symbolic name of a routine that 
processes user input header labels. 


IN!TPG= 


n 


specifies the initial page number; the pages are 
numbered sequentially thereafter. 


INPUT- 


ddname 
(ddname, . . .) 

SYSIN[(cccc)] 


specifies the ddname of a DD statement defining 
a data set used as input to the program. 

specifies that the SYSIN data set contains records 
(other than utility control statements) to be used 
in the construction of output records. 


INREC= 


roufinename 


specifies the symbolic name of a routine that 
manipulates each logical record before it is 
processed. 


INSEPJ= 


YES 


specifies the insertion of a block of logical 
records. 


INTLR= 


cccccccc 
roufinename 


specifies the symbolic name of the user routine 
thct handle; input (SYSUT1) trailer labels. 

specifies the symbolic name of a routine that 
processes user input trailer labels. 


IOERRORf 


roufinename 


specifies fhe symbolic name of a routine thct 
handles permanent I/O error conditions. 


!PL = 


YES 


specifies th-t an I PL program is to be written on 
the volume. 


IPLDD= 


ddname 


specifies the ddname of a DD statement defining 
the data set contcining the [ PL program. 



SectionS: Utilities 8-47 



Definition of Operands (cont'd) 



output- 
location 



specifies the starting position at which a literal 
for this item is to be placed in the output record. 



specifies the title or subtitle literal (maximum 
length of 40 bytes), enclosed in apostrophes. 



routinename 



specifies the symbolic name of a routine that 
creates the output record key. 



indicates the number of records in the SYSIN data 
set to be treated as user labels. The number n 
is a number from 1 to 8. If this parameter is 
included, DATA=INPUT must be coded on a LABELS 
statement before it is in the input stream. 



specifies that an ANS volume label is to be created. 



length 
in bytes 



specifies the length in bytes of the defined field. 



specifies the change (update) level in hexadecimal 
(00-FF). This parameter is valid only when a 
member of a partitioned data set is being processed. 



specifies that the SYSPRINT data set is to contain 
the entire updated member or data set and the con- 
trol statements used in its creation. 

specifies that the names of copied members are not 
to be listed on SYSPRINT at the end of each input 
data set. 



(0^ c)[, (1 ,c, ). . .J)specifies the channels of the FCB image. Each set 
of parentheses must contain the line number (1-180), 
a comma, and the channel number (1-12) to be 
assigned to that line. One or all of the 12 channels 
may be assigned in any order. Each set must be 
separated by commas and the entire group surrounded 
by parentheses. 



specifies that six lines per inch will be printed, 
specifies that eight lines per inch will be printed. 



specifies a number that is no less than the total num- 
ber of FIELD parameters appearing in subsequent 
RECORD statements. MAXFLDS is required if there 
are any FIELD parameters in subsequent RECORD 
statements. 



specifies a number that is no less than the total 
number of IDENT parameters appearing in subsequent 
RECORD statements. MAXGPS is required if there are 
any IDENT parameters in subsequent RECORD state- 
ments. 



specifies the maximum number of lines to a printed 
page. Spaces, titles, and subtitles are included in 
this- number. 



specifies a number that is no less than the total 
number of characters contained in the FIELD or IDENT 
literals of subsequent RECORD statements. 



specifies the number of bytes, plus four for the record 
descriptor word when variable records are specified, 
to be contained in all but the last record passed to 
the output routine when editing is not performed. 



8-48 OS/VS1 Programmer's Reference Digest 



Definition of Operands (cont'd) 



MAXNAME= 




specifies a number that is no less than the total 
number of member names and aliases appearing in 
subsequent MEMBER statements. MAXNAME is 
required if there are one or more MEMBER state- 
ments. 


MEMBER= 


cccccccc 


specifies a name to be assigned to the member 
placed in the partitioned data set defined by the 
SYSUT2 DD statement. 




member-name 


specifies the name of a member of the partitioned 
data set named in the DSNAME parameter, or 
identifies a member to be excluded from the parti- 
tioned data set being moved or copied when the 
EXCLUDE statement modifies a MOVE partitioned 
data set or COPY partitioned data set statement. 




[(] membernamel [,membemame2]. . . [)] 






specifies members on the input data set that are not 
to be copied, unloaded, or loaded to the output data 
set. The members are not deleted from the input data 
set unless the entire data set is deleted. 




name 


specifies the name or alias for a member (in the named 
data set) that is to be processed. 




(name[,name]. 


. .) identifies the members to be moved or copied. 




((name,newname)[, (name,newname)]. . .) 






identifies the members to be moved or copied and 
gives the new name for each member. 




newname 


specifies a newname for a selecfed member. 




R 


specifies that the input member is to replace any 
identically named member that exists on the output 
partitioned data set. The replace option is not 
valid for an unload operation. 


MINLN= 


n 


specifies the byte length of the shortest valid edited 
record. 


MODE= 


mm 


specifies the bit density for data written onto the 
receiving magnetic tape volume. 


MODEL= 


n 


specifies a decimal model number (1 or 2) for the 
2305. 


NAME= 


aliasname 
cccccccc 


indicates the name of the member placed in the 
partitioned data set, or specifies a one- to eight- 
character alias depending on the operation. 




membername 


specifies a member by its member name. 




name 






(namel, . * .) 






(name1,namen 
(name,(COPY= 


..) 
namel, namen.. .)...) 

specifies the name of the field defined by this FD 
statement, or specifies the name(s) of a field(s) to 
be included in the applicable output records, (cont'd) 



Section 8: Utilities 8-49 



Definition of Operands (cont'd) 



Continued from 
preceding page 



COPY indicates that all fields named in the inner 
parentheses (maximum of twenty) are to be treated 
as a group and included the specified number of 
times in each output record. 

) specifies a member name followed by a list of its 
aliases. 



specifies that the old master data set is a sequential 
data set, and that the updated output is to become 
a member of a partitioned data set. 

specifies that the old master data set is a partitioned 
data set, and that a member of that data set is to be 
converted into a sequential data set. 



NEWNAME= name 



specifies the new fully-qualified name for the data 
set, or the new member of alias. 



NEW1 = cccccccc 



specifies the first sequence number assigned to new 
or replacement data, or specifies the first sequence 
number assigned in a renumbering operation. 



NEWVOLID= serial 



specifies a one- to six-character volume serial 
number. 



specifies a qualified name. 



specifies that the message 



secifies that the message data set is not to include 
listing of the output data set. 



specifies the number of tapes to be labeled according 
to specifications made in this control statement. The 
value n represents a number from 1 to 255. 



OUTDD= ddname 



specifies the name of the output partitioned data set. 



OUTHDR= cccccccc 



specifies the symbolic name of the user routine that 
handles any user output (SYSUT2) header labels. 

specifies the symbolic name of a routine that creates 
user output header labels. 



specifies the symbolic name of a routine that receivi 
control during the opening of the SYSUT2 data set. 



OUTHDR3= routinename 



specifies the symbolic name of a routine that receive 
control during the opening of the SYSUT3 data set. 



OUTPUT= (ddname) 



specifies the ddname of the DD statement defining the 
output data set. 



OUTREC= routinename 



specifies the symbolic name of a routine that mani- 
pulates each logical record before it is printed or 
punched, or specifies the symbolic name of a routine 
that receives control before the record is passed to 
the normal output data set (SYSUT2). 



OUTTLR= cccccccc 



routinename 



specifies the symbolic name of the user routine that 
handles any user output (SYSUT2) trailer labels. 



specifies the symbolic name of a routine that 
processes user output trailer labels. 



OUTTLR2= routinename 



specifies the symbolic name of a routine that receives 
control during the closing of the SYSUT2 data set. 



8-50 OS/VS1 Programmer's Reference Digest 



Definition of Operands (cont'd) 



routinename 



specifies the symbolic name of a routine that receiv 
control during the closing of the SYSUT3 data set. 



'ccccccccccfcccc]' 



specifies the owner's name or similar identification. 
The information is specified as character constants, 
and can be up to 10 bytes in length for EBCDIC and 
BCD volume labels, or up to 14 bytes in length for 
ANS volume labels. 



specifies a one- 1 to ten-character name or other 
identifying information. OWNERID is specified as 
an EBCDIC character string with the exclusion of the 
blank and the comma characters. 

specifies a one- to ten-character field that identifies 
the owner of the volume. 



specifies the number of passes to be made in c 
a recording surface i 



alyzing 



specifies that the ANALYZE function is to bypass all 
surface analysis end track formatting, writing only a 
a VTOC, track zero records (I PL bootstrap and volume 
label records), and IPL text if requested. 



specifies that password protected data sets contained i 
the group are to be included in the operation. 



current- 
password 



specifies the current password in the entry to be includ- 
ed in the operation. 



PASSWORD2= new-password specifies the new password to be assigned to the entry. 

The password can consist of one- to eight-alphameric 
characters. 



specifies ihe fully qualified name of the partitioned 
data set to be moved or copied. 



specifies a decimal number that is to be converted to 
binary and right-aligned in the defined field. 

'character string' specifies an EBCDIC character string that is to be 
placed in the defined field or applicable records. 

length specifies the number of bytes the picture will occupy. 

p'decimal number' 

specifies a decimal number that is to be converted to 
packed decimal and right-aligned in the defined field. 

startlbc specifies a starting byte (within any applicable out- 

put record) in which the picture is to begin. 



routinename specifies the symbolic name of a routine that processes 

logical records (physical blocks in the case of VS or 
VBS records longer than 32K bytes) from either or 
both of the input data sets before they are compared. 



specifies that an ASA control character is provided 
as the first character of each record to be printed or 
punched. 



Section 8: Utilities 8-51 



Definition of Operands (cont'd) 


PREFORM= 
(cont'd) 


M 


specifies that a machine-code control character is 
provided as the first character of each record to be 
printed or punched. 


PURGE 




specifies that each data set specified by D5NAME or 
VTOC be scratched, even if its expiration data has 
not elapsed. 


PURGE= 


YES 
NO 


indicates that all unexpired data sets on the volume 
can be overwritten provided that the operator signals 
his concurrence when the first unexpired data set is 
encountered, or that the program may be written over 
any user labels, or over any data that follows the 
volume label record. 

specifies that the operation is to be terminated if an 
unexpired data set is encountered, or specifies that 
the program may not be written over standard user 
labels. 


QUANTITY= 


number 
number[, CREATE 


=number] 

specifies the number of records that this statement is 
to generate (each record is specified by the other 
parameters), or specifies the number of times the 
defined group of CREATE statements is to be used 
repetitively. 

CREATE specifies the number of following CREATE 
statements to be included in the group. 


RANGE= 


number 


specifies an absolute value which the contents 
of this field can never exceed. 


RENAME= 


name 


specifies that the data set is to be renamed, and 
indicates the new name. 


REPLACE^ 


X'xx' 


specifies the hexadecimal representation of the 
character to be used by IEBTCRIN to replace error 
bytes. 


SEQFLD= 


ddi 


specifies, in decimal, the starting column (up to 
column 80) and length (8 or less) of sequence numbers 
within existing logical records and subsequent Data 
statements. 


SEQ> 


cccccccc 
ALL 


specifies the sequence number of the first logical 
record to be renumbered or deleted. 

specifies a renumbering operation for the entire 
member or data set. 


SEQ2= 


cccccccc 


specifies the sequence number of the last logical 
record to be renumbered or deleted. 


SER= 


xxxxxx 


specifies the volume serial number of the first or 
only tape to be labeled. 


SIGN= 


sign 


specifies a mathematical sign (+ or -), which is 
used when defining a packed-decimal or binary 
field. 


SKIP= 


n 


specifies that every nth record is to be printed 
or punched. 



8-52 OS/VS1 Programmer's Reference Digest 



Definition of Operands (cont'd) 



specifies user modifications when the x value is 0, 
or IBM modifications when the x value is 1 . This 
parameter is valid only when a member of a 
partitioned data set is being processed. 



specifies eight hexadecimal characters of system 
status information to be placed in the directory 
of the new master data set as four packed hexa- 
decimal bytes of user data. 



jobname 



specifies the name of the input job to which the 
EDIT statement applies. 



specifies a starting location (within all output 
records using this field) in which a field is to 
begin. 



starting-byte 
location 



specifies the first job step to be placed in the output 
data set when coded with TYPE=POSITION. Job 
steps preceding this step are not copied to the output 
data set. When coded with TYPE=INCLUDE or 
TYPE-EXCLUDE, STEPNAME specifies the names of 
job steps that are to be included in, or excluded 
from, the operation. 



specifies, for sequential data sets, the number of 
logical records to be punched or printed. For parti- 
tioned data sets, this specifies the number of logical 
records to be punched or printed in each member to 
be processed. 



specifies the one- to five-byte track address, relative 
to the beginning of the volume, at which the VTOC 
is to begin. 



specifies, for sequential data sets, the number of logi- 
cal records to be skipped before printing or punching 
begins. For partitioned data sets, STRTAFT=n speci- 
fies the number of logical records to be skipped in 
each member before printing or punching begins. 



specifies that data sets that are to be scratched have 
names that begin with "AAAAAAAA.AAAAAAAA. 
AAAAAAAA.AAAAAAAA." or "SYSnnnnn.T" and 
"F" or "V" in position 19. These names are assigned 
to data sets by the operating system. 



device= 
list 



specifies the volume(s) to which the data set(s) is to 
be moved or copied. 



device= specifies the device type and volume serial number of 

serial the volume to which the partitioned data set or 

cataloged entries are to be moved or copied. 



specifies the channel number, c, and unit number, uu, 
of the message output or receiving device. 



cuu 



ddname 
(ddname, . ..) 



specifies the channel and unit address of the direct 
access device containing the volume to be processed. 

specifies the ddname of a DD statement defining the 
device that contains the volume to be processed. 



specifies the type of output or receiving device, for 
example, 2400. 



Section 8: Utilities 8-53 



Definition of Operands (cont'd) 



TOTAL= 


roytinename 


specifies the name of the user's totaling routine. 




size 


specifies the number of bytes required, for the 
user's data. 


TOTCONV= 


PZ 


specifies that data (packed decimal mode) is to 
be converted to unpacked decimal mode. 




XE 


specifies that data is to be printed or punched in 
2-character-per-byte hexadecimal representation 
(for example C3, 40, F4,F6). 


TRACK= 


cccchhhh 


specifies the address of the track for which an 
alternate is requested, where cccc is the cylinder 
number and hhhh is the head number. 


TRANS= 


name 


specifies a user-translate table to be used by 
IEBTCRIN. 




NOTRAN 


specifies that no translation and no special pro- 
cessing is to be performed. 




STDLC 


specifies that the MTST code is to be translated 
to standard EBCDIC, alphabetic characters are 
translated as lowercase. 




STDUC 


specifies that the MTST code is to be translated to 
standard EBCDIC; alphabetic characters are trans- 
lated to uppercase. 


TYPE= 


code 


specifies the protection code of the password and, 
if a control password is being assigned to a direct 
access, online data set, specifies the protection 
status of the data set. 




EXCLUDE 


specifies that the output data set is to contain a 
JOB statement and all job steps belonging to the 
job except those steps specified in the STEPNAME 
parameter, 




INCLUDE 


specifies that the output data set is to contain, a 
JOB statement and all job steps specified in the 
STEPNAME parameter. 




MTDI 


specifies that the input was created on a 
Magnetic Data Inscriber. 




MTST 


specifies that the input data was created on a 
Magnetic Tape Selectric Typewriter, 




POSITION 


specifies that the output is to consist of a JOB 
statement, the job step specified in the STEPNAME 
parameter, and all steps that follow it. 


TYPORG= 


PO 


specifies that the input data sets are partitioned 
data sets. 




PS 


specifies that the input data sets are sequential 
data sets. 


UNCATLG 




specifies that the catalog entry pertaining to the 
data set is to be removed. 


UPDATE= 


INPLACE 


specifies the old master data set is to be updated 
within the space it actually occupies. The old 
master data set must reside on a direct access 
device. UPDATE is valid only when coded 
with CHANGE. 



8-54 OS/VS1 Programmer's Reference Digest 



Definition of Operands (cont'd) 


VERCHK= 


NOCHK 
VOKCHK 


specifies that no record verification check is 
to be made. 

specifies that a record verification check is to 
be made. 


VOL- 


device- 
list 

device- 
serial 


specifies the volume or volumes that contain the 
data set to be processed. 

specifies the device type and volume serial number 
of the volume to be processed. 


VOLID- 


SCRATCH 

serial 

serial [, serial].. 


specifies that no volume serial number check is to. 
be made. 

. specifies the volume serial number of the volume to 
be processed. 


VOLPASS= 




1 


specifies that the volume is not security protected. 
If VOLPASS is omitted, is assumed. 

specifies that the volume is security protected. 


VOLUME- 


device- 
serial 


specifies the device type and volume serial number 
of the source volume. 


VTOC 




specifies that all data sets on the specified volume, 
except those protected by a password or those whose 
expiration dates have not yet expired, are to be 
scratched. 


VTOC- 


" 


specifies a one- to five-byte decimal relative 
track address representing a primary track on 
which the volume table of contents is to begin. 
The VTOC cannot occupy track 0. 



Section 8: IMities S%55 



8-56 0S/VS1 Programmer's Reference Digest 



Section 9: Bibliography 



OS/VS1 Publication Support 9-2 



Source Publications 



This section lists all the publications that support VS1. Applicable 
TNLs and suffix numbers are not included. 

Note: OS/VS System Generation Introduction, GC26-3790, which 
supports VS1 Release 1, is no longer included in this section; content 
relevant to VS1 is included in OS/VS 1 System Generation Reference, 
GC26-3791. Operator's Library: OS/VS1 RES, GC38-0330, is 
removed from the VS1 library. Its content is included in Operator's 
Library: OS/VS1 Reference, GC38-01 10. 

If additional information is required, refer to the OS/VS 1 Release 3 
Guide, GC24-5098, or the IBM System/ 360 and System/ 3 70 
Bibliography, GA22-6822. 



Section 9: Bibliography 9-1 



0S/VS1 Publication Support 

General and Planning Information 

IBM System/360 and System/370 Bibliography GA22-6822 

OS/VS1 Master Index GC24-5104 

OS/VS1 Master Index of Logic GY24-5164 

OS/VS Program Planning Guide for IBM 3886 GC2 1-5069 

Optical Character Reader Model 1 

IBM Data Processing Glossary GC20-1699 

Introduction to Virtual Storage in System/370 GR20-4260 

IBM System/370 System Summary GA22-7001 

DOS to OS/MFT, OS/MVT, OS/VS 1 GC24-5082 

Management Planning Guide 

DOS to OS/VS 1 Implementation Guide GC24-5095 

OS/VS 1 Planning and Use Guide GC24-5090 

OS/VS 1 Release 1 Guide GC24-5092 

OS/VS 1 Release 2 Guide GC24-5097 

OS/VS1 Release 2.6 Guide GC24-5102 

OS/VS 1 Release 3 Guide GC24-5098 

OS/VS 1 Storage Estimates GC24-5094 

OS/VS System Management Facilities (SMF) GC35-0004 

OS/VS1 System Generation Reference GC26-3791 

OS/MFT, OS/MVT, and OS/VS 1 CRJE GC30-2012 

Concepts and Facilities 

OS/MFT, OS/MVT, and OS/VS 1 CRJE GC30-2016 

System Programmer's Guide 

OS/VS Virtual Storage Access Method (VSAM) GC26-3799 

Planning Guide 

Operations and Messages 

Operator's Library: OS/VS Console Configurations GC38-0120 

Operator's Library: OS/VS 1 CRJE GC38-0335 

Operator's Library: OS/VS 1 Display Consoles GC38-0255 

Operator's Library: OS/VS 1 Reference GC38-0110 

Operator's Library: OS/VS TCAM GC30-2037 

OS/VS Message Library: Linkage GC38-1007 

Editor and Loader Messages 

OS/VS Message Library: Routing and Descriptor Codes GC38-1004 

OS/VS Message Library: Service Aids GC38-1006 

and OLTEP Messages 

OS/VS Message Library: VS1 System Codes GC38-1003 

OS/VS Message Library: VS1 System Messages GC38-1001 

OS/VS Message Library: Utilities Messages GC38-1005 

OS/VS Message Library: VS1 RES RTAM and Account GC38-1010 

Messages 

Programming - General 

OS/VS1 Programmer's Reference Digest GC24-5091 

OS/VS 1 System Data Areas SY28-0605 

Programming - Assembler 

OS/VS and DOS/VS Assembler Language GC33-4010 

OS/VS Assembler Programmer's Guide GC33-4021 

OS/VS Assembler Logic SY33-8041 . 

Programming - Job Management 

OS/VS 1 JCL Services GC24-5100 

OS/VS 1 JCL Reference GC24-5099 

OS/VS JCL Syntax Reference Summary GX28-0619 

OS/VS 1 Job Management Logic SY24-5161 

Programming - Utilities 

OS/VS Utilities GC35-0005 

OS/VS Utilities Logic SY35-0005 

Programming - Linkage Editor and Loader 

OS/VS Linkage Editor and Loader GC26-3813 

OS/VS Linkage Editor Logic SY26-3815 

OS/VS Loader Logic SY26-3814 



9-2 OS/VS 1 Programmer's Reference Digest 



0S/VS1 Publication Support (cont'd) 



Programming - Data Management 

OS/VS Checkpoint/Restart 

OS/VS1 Data Management for System Programmers 

OS/VS Data Management Macro Instructions 

OS/VS Data Management Services Guide 

OS Data Management Services and Macro Instructions 

for IBM 1419/1275 
OS Data Management Services and Macro Instructions 

for IBM 1285/1287/1288 
OS/VS Tape Labels 
OS/VS Virtual Storage Access Method (VSAM) 

Options for Advanced Applications 
OS/VS Virtual Storage Access Method (VSAM) 

Programmer's Guide 
OS/VS Access Method Services 
OS/VS 1 BDAM Logic 
OS BSAM Logic for IBM 1419/1275 
OS/VS 1 Catalog Management Logic 
OS/VS 1 Checkpoint/Restart Logic • 
OS/VS 1 DADSM Logic 
OS Data Management Macro Logic for IBM 

1285/1287/1288 
OS/VS 1 ISAM Logic 
OS/VS 1 Open/Close/EOV Logic 
OS/VS 1 SAM Logic 
OS/VS 1 Access Method Services Logic 
OS/VS 1 Virtual Storage Access Method (VbAM) Logic 
3890 Document Processor, Machine and 

Programming Description 
OS/VS 3890 Document Processor Logic, 
OS/VS 3886 Optical Character Reader, Model 1 
OS/VS 3886 Optical Character Reader, Model 1 Logic 

Programming - Supervisor 

OS/VS 1 Supervisor Services and Macro Instructions 
OS/VS1 IPL and NIP Logic 
OS/VS 1 Supervisor Logic 
OS/VS 1 I/O Supervisor Logic 

Programming - RAS 

OS/VS1 Debugging Guide 

OS/VS 1 OLTEP 

OS/VS i Service Aids 

OS/VS 1 OLTEP Logic 

OS/VS Service Aids Reference Summary 

OS/VS 1 Recovery Management Support Logic 

OS/VS 1 Service Aids Logic 

OS/VS 1 SYS1.LOGREC Error Recording 

OS/VS I SYS1.LOGREC Error Recording Logic 

OS/VS DSS Command Language Reference Summary 

OS/VS Dynamic Support System 

OS/VS 1 Dynamic Support System Logic 

Programming - Remote Entry 

IBM 3735 Programmer's Guide (OS, DOS, and VS Systems) 
OS/MFT, OS/MVT, and OS/VS 1 CRJE Terminal 

User's Guide 
OS/MFT, OS/MVT, and OS/VS 1 CRJE Logic 
OS/VS 1 RES Workstation User's Guide 
OS/VS1 RES System Programmer's Guide 
OS/VS 1 RES RTAM and Workstation Support Logic 
OS/VS 1 RES Account Facilities Logic 
IBM 3735 Programmable Buffered Terminal: 

Form Description Macro Instructions and Form 

Description Utility: Program Logic Manual 

(OS, DOS, and VS Systems) 



GC26-3784 
GC26-3837 
GC26-3793 
GC26-3783 
GC2 1-5006 

GC21-5004 

GC26-3795 
GC26-3819 

GC26-3838 

GC26-3836 
SY26-3836 
GY21-0012 
SY35-0003 
SY24-5159 
SY26-3837 
GY21-0013 

SY26-3838 
SY26-3839 
SY26-3840 
SY35-0008 
SY26-3841 
GA24-3612 

SY24-5163 
GC24-5101 
SY24-5162 



GC24-5103 
SY24-5160 
SY24-5155 
SY24-5I56 

GC24-5093 
GC28-0666 
GC28-0665 
SY28-0662 
GX28-0634 
SY27-7239 
SY28-0635 
GC28-0668 
SY28-0669 
GX28-0690 
GC28-0640 
SY28-0672 



GC30-3001 
GC30-2014 

GY30-2011 
GC28-6879 
GC28-6878 
SY28-6849 
SY28-0660 
GY30-3O0O 



Section 9: Bibliography 9-3 



0S/VS1 Publication Support (cont'd) 



Programming - Teleprocessing 

OS/VS BTAM 

OS/VS BTAM Logic 

OS TCAM Concepts and Facilities 

OS/VS TCAM Programmer's Guide 

OS/VS TCAM Level 4 Component Release Guide 

OS/VS TCAM User's Guide 

OS/VS TCAM Logic 

Introduction to VTAM 

VTAM Application Programmer's Reference 

Programming - Information Display System 

OS/VS Graphic Programming Services 

(GPS) for IBM 2250 Display Unit 
OS/VS Graphic Programming Services 

(GPS) for IBM 2260 Display Station 

(Local Attachment) 
OS/VS Graphic Subroutine Package 

(GSP) for FORTRAN IV* COBOL, and PL/I 
OS/VS Problem Determination Aids and Messages 

and Codes for GPS and GSP 
OS/VS Graphic Access Method Logic 
OS/VS Graphics Problem-Oriented Routines Logic 
OS/VS Graphic Subroutine Package (GSP) for 

FORTRAN IV, COBOL, and PL/I Logic 
An Introduction to the IBM 3270 Information 

Display System 



GC27-6980 
SY27-7246 
GC30-2022 
GC30-2044 
GC30-2036 
GC30-2025 
SY30-2049 
GC27-6987 
GC27-6995 



GC27-6971 
GC27-6972 

GC27-6973 

GC27-6974 

SY27-7240 
SY27-7241 
SY27-7242 



9-4 OS/VS 1 Programmer's Reference Digest 



Index 

Indexes to 0S/VS1 publications are consolidated in the OS/VS1 Master Index, GC24-5104, 
and the OS/VS1 Master Index of Logic, GY24-5164. These master indexes reference other 
publications that contain additional information about the subjects listed here. 



ABEND 

completion code 2-25 

macro 3-2, 3-1 1 
ACB macro 4-33 
add instructions 1-17 to 1-19 
address format, virtual 1-60 
aliases, CRJE commands 5-22 
AND instructions 1-19 
ANSI 

control characters 1-16 

header and trailer labels 4-25,4-26 

standard labels 4-21 to 4-23 

standard volume label 4-24 

user labels 4-27 
AS macro 7-2,7-11 
ASCII 

fixed length records, tapes 4-29 

graphics and controls 1-2 to 1-6 

undefined length records, tapes 4-31 

variable length records, tapes 4-32 
ASCTR macro 7-2,7-11 
ASLIST macro 7-2,7-11 
ASMTRTAB macro 7-2, 7-7 
assembler 

label processing 4-28 

system attributes 1-57 

system conditional assembly expressions 1-56 

system constants 1-54 

system instructions 1-50 to 1-52 

system macro language statements 1-55 

system statements 1-53 

system variable symbols 1-58, 1-59 
associated logical channel word 2-33 
ATTACH 

completion codes 2-27 

macro 3-2, 3-1 1 



BCmode, PSW 1-11 

BCDIC graphics and controls 1-2 to 1-6 

BDAM 

completion codes 2-20, 2-21 

data sets, spanned records 4-31 

macros 4-2 to 4-12 
bibliography 9-1 

binary synchronous communications, BTAM 7-14 
BISAM 

completion codes 2-20, 2-21 

macros 4-2 to 4-12 
BLDL macro 4-2 
block descriptor word 4-30,4-31 
block length 4-30,4-31 
blocked records 4-29 to 4-32 
BPAM 

flow of control 4-39 

macros 4-2 to 4-12 
branch instructions 1-20 to 1-22 
BRDCST command* 5-24 
BSAM 

completion codes 2-20, 2-26 

flow of control 4-39 

Index 



BSAM (cont'd) 

macros 4-2 to 4-12 

BTAM 

completion codes 2-21, 2-22 
section on 7-1 to 7-14 

BSP macro 4-2 

build list, resident 2-35 

BUILD macro 4-2 

BUILDRCD macro 4-2,4-3 



CALL macro 3-3,3-11 
CANCEL command 
CRJE 5-19 

operator 5-8 

RES 5-14 
CANCELMG macro 7-15 
capacities, linkage editor 6-7 
CAW (channel address word) 1-1 2 
CCW (channel command word) 1-12 
CENOUT command 5-24 
central operator commands, RES 5-1 2 
channel address word (CAW) 1-1 2 
channel command word (CCW) 1-12 
channel status word (CSW) 1-12 
CHAP 

completion codes 2-27 

macro 3-3, 3-11 
CHGNTRYmcaro 7-2,7-7 
CHECK macro 

data management 4-3 

TCAM 7-15 

VSAM 4-33 
CHECKPT macro 7-15 
CHKPT 

completion code 2-28 

macro 4-3 
CKREQ macro 7-15 
clear I/O instruction 1-22 
CLOSE 

BTAM macro 7-2,7-7 

completion codes 2-26 

data management macro 4-4 

TCAM macro 7-15 

VSAM macro 4-33 
compare instructions 1-22 to 1-24 
convert instructions 1-24 
CNOP alignment 1-9 
CNTRL macro 4-4 
COBOL label processing 4-28 
CODE macro 7-15 
code translation table 1-2 to 1-6 
codes 

completion 2-20 to 2-29 

condition 1-8 

I/O command 1-14 to 1-16 

machine-check interruption 1-13 

program interruption 1-9 

wait state 2-30, 2-31 
commands 

CRJE 5-19 to 5-22, 5-24 

operator 5-1, 5-8 to 5-11 

RES central operator 5-1 2 

RES workstation operator 5-14, 5-15 

TCAM operator 7-21 to 7-23 
COMMBUF macro 7-15 
comment statement 5-2 

OS/VS1 Programmer's Reference Digest 



completion codes 

for data management macros 4-2 to 4-12 

summary 2-20 to 2-29 
component support of label processing features 4-28 
condition codes 1-8 

conditional assembly expressions, system assembler 1-56 
CONFIGUR macro 7-2,7-11 
console printer command codes 1-14 
contents supervisor completion codes 2-24 
CONTINUE command 5-19 
control characters, ANSI 1-16 
control codes, segment 4-30,4-31 
control registers 1-7 

control statements, linkage editor 6-6 

conversational remote job entry (CRJE) 5-1, 5-18 to 5-24 

conversion, decimal and hexadecimal 1-60, 1-62 to 1-66 

COUNTER macro 7-15 

CRJE (conversational remote job entry) 5-1, 5-18 to 5-24 

CRJELINE macro 5-18 

CRJETABLE macro 5-18 

CRJEUSER macro 5-18 

CSW (channel status word) 1-1 2 

CTBFORM macro 7-15 

CTRGROUP macro 7-2, 7-12 

CTRLIST macro 7-3,7-12 

CTRSCHED macro 7-3,7-12 

CUTOFF macro 7-15 



data management 

commands for CRJE 5-21 

macros 4-2 

section on 4-1 
data set, device allocation 2-19 
data set record formats 4-29 to 4-32 
data set utility programs 8-2 
DATAMGT macro 7-3 
DATETIME macro 7-15 
DCB macro 

BTAM 7-3,7-7 

data management 4-5 
DCBD macro 4-5 
DD statement 

format 5-5 to 5-7 

loader use of 6-10 
decimal and hexadecimal conversion 1-60, 1-62 to 1-66 
DEFINE command 5-8 
definition of operands, utilities 8-43 to 8-55 
definition of substitutional operands 5-13, 5-16 
DELETE 

command 5-19 

macro 3-3,3-11 
delimiter statement 5-2 
DEQ 

completion codes 2-27 

macro 3-3, 3-12 
DETACH 

completion code 2-28 

macro 3-3,3-12 
DEULIST macro 7-3,7-12 
device allocation for new data sets 2-19 
device capacities 4-13 

device configurations supported by TCAM 7-24 to 7-29 
device information, UCB sense bytes 2-6 to 2-15 
device statistics table 2-16 to 2-18 
DFTRMLST macro 7-3,7-7 
diagnose instruction 1-24 
direct access device capacities 4-13 



dispatch resume PSW (DSPSW) 2-4 

DISPGUID macro 7-3 

DISPLAY command 5-8, 5-14 

divide instructions 1-25, 1-26 

DOM macro 3-3,3-12 

DSP interruption 2-3 

DSPPSW (dispatch resume PSW) 2-4 

DUMP command 5-8 

DXR macro 3-3,3-12 

dynamic address translation 1-60 



EBCDIC graphics and controls 1-2 to 1-6, 1-67 

EC mode, PSW 1-11 

EDIT and EDMK pattern characters 1-9 

EDIT command 5-19 

edit instructions 1-26 

edit subcommands, CRJE 5-20 

EDMK and EDIT pattern characters 1-9 

ENQ 

completion codes 2-28 

macro 3-3,3-12 
ENQ/DEQ names 2-32 
ENDREQ macro 4-33 
EOV completion codes 2-28 
ERASE macro 4-33 
ERRORMSG macro 7-15 
ESETL macro 4-5 
ESR completion codes 2-29 
exclusive OR instruction 1-26, 1-27 
EXCP completion codes 2-22, 2-23 
EXEC 

command 5-19, 5-22 

statement 5-4 
execute instruction 1-27 
execute statement 

linkage editor 6-3, 6-4 

loader 6-9 
exit routine, CRJE 5-22 
EXLST macro 4-33 

extended binary coded decimal interchange code (EBCDIC) 1-67, 1-68 
EXTRACT 

completion codes 2-27 

macro 3-4 



FEOV macro 4-5 
FIND macro 4-5 
fixed-length records 4-29 
fixed storage locations 1-10 
flow of control in 

BSAM and in BPAM 4-39 

QSAM 4-38 

supervisor 3-35 to 3-39 
FORTRAN label processing 4-28 
FORWARD macro 7-15 
FREEBUF macro 4-5 
FREEDBUF macro 4-5 
FREEMAIN 

completion codes 2-24, 2-25 

macro 3-4, 3-12 
FREEPOOL macro 4-5 



OS/VS1 Programmer's Reference Digest 



GAM (graphics access method) completion codes 2-21 

GDUAS macro 7-3 

GDULIST macro 7-3 

GDUTRANS macro 7-3 

GENCB macro 4-33,4-34 

general information 1-1 

general services, supervisor 3-31, 3-32 

GET macro 

data management 4-5 

TCAM 7-15 

VSAM 4-34 

GETBUF macro 4-6 
GETMAIN 

completion codes 2-24, 2-25 

macro 3-5, 3-12 
GETPOOL macro 4-6 

graphics access method (GAM) completion codes 2-21 
graphics and controls, BCDIC, EBCDIC, and ASCII 1-2 to 1-6 
GROUP macro 7-16 
GTR ACE macro 3-5,3-13 
guide to utility program functions 8-3, 8-4 



HALT command 5-8 

halt instructions 1-27 

halve instructions 1-27 

header labels, ANSI 4-25, 4-26 

hexadecimal addition, multiplication, subtraction tables 1-61 

hexadecimal and decimal conversion 1-60, 1-62 to 1-66 

HOLD 

command 5-8, 5-14 

macro 7-16 
how to find 2-33 to 2-35 



I/O command codes 1-14 to 1-16 
I/O interruption 2-3 
IBCDASDI utility 8-5,8-6 
IBCDMPRS utility 8-7 
ICAPRTBL utility 8-8 
ICHNG macro 7-16 
ICOPY macro 7-16 
IDENTIFY macro 3-5,3-13 
IEAEXSAV save area 2-4 
IEBCOMPR utility 8-9 
IEBCOPY utility 8-10,8-11 
IEBDG utility 8-12 to 8-14 
IEBEDIT utility 8-15 
IEBGENER utility 8-16, 8-17 
IEBISAM utility 8-18 
IEBPTPCH utility 8-19,8-20 
IEBTCRIN utility 8-21 to 8-25 
IEBUPDTE utility 8-26 to 8-28 
IEHATLAS utUity 8-29 
IEHDASDR utility 8-30 to 8-32 
IEHINITT utility 8-33 
IEHIOSUP utility 8-34 
IEHLIST utility 8-35 
IEHMOVE utility 8-36 to 8-38 



Index 



IEHPROGM utility 8-39 to 8-41 

IFHSTATR utility 8-42 

INBLOCK macro 7-16 

INBUF macro 7-16 

independent utility programs 8-2 

INEND macro 7-16 

information, system 2-1 

INHDR macro 7-16 

INITIATE macro 7-16 

INMSG macro 7-16 

INTRO macro 7-16 

INVLIST macro 7-16 

insert characters instructions 1-27 

insert PSW-key instructions 1-28 

insert storage-key instruction 1-28 

installation variables, CRJE 5-22 

instruction formats, machine 1-6 

instructions 

System/370 1-2 to 1-6, 1-17 to 1-49 
system assembler 1-50 to 1-52 

interrupt handlers 3-34 to 3-37 

interruption code, machine check 1-13 

IODEVICE macro, BTAM 7-3 

IORGSAV save area 2-4 

ISAM completion codes 2-20 



JCL (job control language) 5-1 
JCL statements 

linkage editor 6-2 

loader 6-8 
job control language (JCL) 5-1 
job processing commands, CRJE 5-21 
job scheduler completion codes 2-22 
JOB statement 5-3 
job steps, incompatible in linkage editor 6-5 



labels 

ANSI header and trailer 4-25, 4-26 

ANSI standard volume 4-24 

ANSI user 4-27 

IBM standard 4-14,4-15 

IBM standard data set 4-18,4-19 

IBM standard volume 4-17 

processing features 4-28 

processing of ANSI standard 4-23 

processing of IBM standard 4-16 

user 4-20 

volume organization with ANSI standard 4-21, 4-22 
LERB macro 7-4, 7-8 
LERPRT macro 7-4,7-8 
library routines, retrieval of 3-34 
limited channel logout 1-13 

line and station configuration supported by BTAM 7-13, 7-14 
LINK macro 3-5,3-13 
linkage editor 6-1 to 6-7 
linkage editor label processing 4-28 
linkage register conventions 2-5 
LISTBC command 

CRJE 5-19 ' 

operator 5-8 

RES 5-14 
LISTDS command 5-19 
LISTLIB command 5-19 



OS/VS1 Programmer's Reference Digest 



LOAD 

completion code 2-24 

macro 3-6, 3-13 
load instructions 1-28 to 1-31 
load module control 3-27 
loader 6-1, 6-8 to 6-13 
LOCK macro 7-16 
LOCOPT macro 7-16 
logical address format 1-60 
logical channel word, associated 2-33 
logical records 4-30,4-31 
LOG 

command 5-8, 5-14 

macro 7-16 
LOGOFF command 

CRJE 5-19 

operator 5-8 

RES 5-14 
LOGON command 

CRJE 5-19 

operator 5-8 

RES 5-14 
LOGTYPE macro 7-16 
LOPEN macro 7-4,7-8 



machine instruction formats 1-6 

machine-check interruption code 1-13 

macro language statements, system assembler 1-55 

macro parameter notation, supervisor 3-10 

macro parameters, loader 6-1 1 

macros 

BTAM 7-2 to 7-10 

CRJE 5-18 

data management 4-2 

loader 6-10 

supervisor 3-2 to 3-9 

VSAM 4-33 to 4-37 

2715 user table 7-11,7-12 
master scheduler completion codes 2-26, 2-27 
MCOUNT macro 7-17 
MCPCLOSE macro 7-17 
message commands, CRJE 5-22 
MHGET macro 7-17 
MHPUT macro 7-17 
MODCB macro 4-34,4-35 
MODE command 5-9 
MODIFY command 

CRJE 5-24 

operator 5-9 

RES 5-14 
module to SVC directory 3-23 to 3-26 
monitor call instruction 1-32 
MONITOR command 5-9, 5-14 
MOUNT command 5-9 
move instructions 1-32, 1-33 
MRCHECK macro 7-17 
MRELEASE macro 7-17 
MSG command 5-24 
MSGEDIT macro 7-17 
MSGFORM macro 7-17 
MSGGEN macro 7-17 
MSGLIMIT macro 7-17 
MSGRT command 5-9 
MSGTYPE macro 7-17 
multiply instructions 1-33 to 1-37 



Index 



no-operation instructions 1-37 
nonspanned variable-length records 4-30 
nons witched multipoint lines, BTAM 7-13 
NOTE macro 4-6 
null statement 5-2 



on-line terminal test, in CRJE 5-23 
ONLTST macro 7-4,7-8 
OPEN 

BTAM macro 7-2,7-8 

completion codes 2-25, 2-26 

data management macro 4-6 

TCAM macro 7-1 7 

VSAM macro 4-35 
open executor selectors, SAM 4-40 to 4-42 
operands 

definition of, for utilities 8-43 to 8-55 

substitutional 5-13, 5-16 

supervisor 3-11 to 3-16 
operator command outlines 5-8 to 5-11 
operator commands 

RES central 5-12 

RES workstation 5-14, 5-15 

section on 5-1 

TCAM 7-21 to 7-23 
OPTION macro 7-17 
OR instructions 1-37 
ORIGIN macro 7-17- 
OUTBUFF macro 7-17 
OUTEND macro 7-18 
OUTHDR macro 7-18 
OUTMSG macro 7-18 
OUTPUT command 5-19 
overlay supervisor completion codes 2-27 



pack instruction 1-37 

page table entry 1-60 

PAGETUNE command 5-9 

paging completion code 2-29 

parameter notation, supervisor macro 3-10 

parameters, SIZE and REGION guidelines 6-4 

PARAMNUM macro 7-4 

PARMLIST macro 7-4 

passwords, CRJE 5-23 

PATH macro 7-18 

PCB macro 7-18 

PDAB macro 4-7 

PDABD macro 4-7 

PDSAV save area 2-4 

PEND statement 5-2 

PGRLSE macro 3-6,3-13 

PISAV save area 2-4 

PL/I label processing 4-28 

POINT macro 

data management 4-7 

TCAM 7-18 

VSAM 4-35 
point-to-point communications, BTAM 7-14 
POST 

completion codes 2-23 

macro 3-6, 3-13 
powers of 16 table 1-60 

8 OS/VS1 Programmer's Reference Digest 



powers of 2 table 1-60 
PRIORITY macro 7-18 
PROC statement 5-2 
program interrupt control 3-30 
program interruption codes 1-9 
' program status word (PSW) 1-1 1 
programming conventions for SVC routines 3-1 7 
prologue completion codes 2-22 
PRTOV macro 4-7 
PSW (program status word) 1-11 
publication support 9-2 to 9-4 
purge translation lookaside buffer instruction 1-37 
PUT macro 

data management 4-7 

TCAM 7-18 

VSAM 4-35 
PUTX macro 4-7 



QISAM 

completion codes 2-20, 2-21 

macros 4-2 to 4-1 2 
QRESET macro 7-18 
QSAM 

completion codes 2-20 

flow of control 4-38 

macros .4-2 to 4-1 2 
QSTART macro 7-18 



RAM list 2-35 

RDJFCB completion codes 2-29 
read direct instruction 1-38 
READ macro 

BTAM 7-5,7-8 

data management 4-7 

TCAM 7-18 
READY macro 7-18 
record descriptor word 4-30,4-31 
record formats 

data set 4-29 to 4-32 

linkage editor 6-7 
REDIRECT macro 7-18 
REGION parameter, linkage editor 6-4 
register contents, for SVCs 3-18 to 3-22 
register conventions, linkage 2-5 
register usage 2-4 
registers, control 1-7 
RELBUF macro 7-5,7-9 
RELEASE command 5-10, 5-14 
RELEX macro 4-8 
RELSE macro 4-8 
remote entry services (RES) 5-1 
REPLY command 5-10,5-14 
REQBUF macro 7-5,7-9 
requirements, virtual storage for loader 6-13 
RES (remote entry services) 

central operator commands 5-12 

definition of substitutional operands 5-16 

section on 5-1 

workstation operator command outlines 5-14, 5-15 
RESET command 5-10,5-14 
reset reference bit instruction 1-38 
RESETPL macro 7-5,7-9 
resident build list 2-35 
resident SVC load list 2-35 



Index 



restrictions, CRJE 5-23 
RETRY macro 7-18 
return codes 

IEBCOMPR 8-9 

IEBCOPY 8-10 

IEBDG 8-12 

IEBEDIT 8-15 

IEBGENER 8-16 

IEBISAM 8-18 

IEBPTPCH 8-19 

IEBTCRIN 8-21 

IEBUPDTE 8-26 

IEHDASDR 8-30 

IEHINITT 8-33 

IEHIOSUP 8-34 

IEHLIST 8-35 

IEHMOVE 8-36 

IEHPROGM 8-39 

linkage editor 6-5 

loader 6-12 
RETURN macro 3-6,3-14 
ROUTE command 5-10, 5-14 
routing codes for multiple consoles, CRJE 5-23 
RPG label processing 4-28 
RPL macro 4-35 



SAM open executor selectors 4-40 to 4-42 

save area format 2-2 

save areas, how to find 2-4 

SAVE macro 3-6,3-14 

SCREEN macro 7-18 

segment control codes 4-30, 4-31 

segment descriptor word 4-30,4-31 

segment length 4-30,4-31 

segment table entry 1-60 

SEGWT macro 3-6,3-14 

SEND command 

CRJE 5-19 

operator 5-10 

RES 5-14 
sense information, UCB 2-6 to 2-15 
SEQUENCE macro 7-18 
session management commands, CRJE 5-21 
SET command 5-10 
set instructions 1-38, 1-39 
SETEOF macro 7-19 
SETEOM macro 7-19 
SETL macro 4-8 
SETPRT macro 4-8,4-9 
SETSCAN macro 7-19 
shift instructions 1-39, 1-40 
SHOW command 5-24 
SHOWCB macro 4-35,4-36 
signal processor instruction 1-40 
SIO interruption 2-3 
SIZE parameter, linkage editor 6-4 
SLOWPOLL macro 7-19 
SMF (system management facilities) 5-1, 5-17 
SMFPRMxx parameters 5-17 
SNAP macro 3-6,3-14 
sort/merge label processing 4-28 
spanned variable-length records 4-30, 4-31 
SPIE macro 3-6, 3-14 
STAE macro 3-7 

standard command code assignments 1-14 
standard data set label, IBM- 4-1 8, 4-19 
standard label processing, ANSI 4-23 

10 OS/VS1 Programmer's Reference Digest 



standard label processing, IBM 4-16 
standard labels, IBM 4-14,4-15 
standard volume label, ANSI 4-24 
standard volume label, IBM 4-17 
START command 

CRJE 5-24 

operator 5-10 

RES 5-14 
start I/O instructions 1-40, 1-41 
start-stop communications, BTAM 7-13 
STARTMH macro 7-19 
statements 

comment 5-2 

DD 5-5 to 5-7 

delimiter 5-2 

EXEC 5-4 

JOB 5-3 

null 5-2 

PEND 5-2 

PROC 5-2 
station configurations supported by BTAM 7-13, 7-14 
statistics table, device 2-16 to 2-18 
STATUS command 5-19 
status information commands, CRJE 5-21 
STEND macro 7-5,7-12 
STIMER macro 3-7,3-14 
STIMERE macro 3-7,3-14 
STOP command 

CRJE 5-24 

operator 5-10 

RES 5-14 
STOPMN command 5-11,5-14 
storage locations, fixed 1-10 
storage requirements, loader 6-13 
store instructions 1-41 to 1-43 
STOW macro 4-10 
SUBMIT command 5-19 

substitutional operands, definition of 5-13, 5-16 
subtract instructions 1-43 to 1-46 
summary of supervisor operands 3-1 1 to 3-1 6 
supervisor call 

completion codes 2-29 

instruction 1-47 
supervisor 

flow of control 3-35 to 3-39 

information 3-1 to 3-59 

macro outlines 3-2 to 3-9 

macro parameter notation 3-10 

operands, summary of 3-11 to 3-16 
SVC directory 3-23 to 3-26 
SVC interruption 2-3 
SVC load list, resident 2-35 
SVC register contents 3-1 8 to 3-22 
SVC routines, programming conventions 3-1 7 
SVC table format 2-34, 2-35 
SVCs, how to find type 1 and type 2 2-34 
SVCSAV save area 2-4 
SWAP 

command 5-11 

completion codes 2-29 
SWITCH command 5-11 
switched lines, BTAM 7-13 
SYNADAF macro 4-10 
SYNADRLS macro 4-10 
synchronization 3-28, 3-29 
syntax checkers, CRJE 5-23 
SYSOUT class, CRJE 5-23 . 
system 

ENQ/DEQ names 2-32 

information 2-1 



Index 



system (cont'd) 

operator commands for CRJE 5-24 

register usage 2-4 

utility programs 8-2 
system assembler 

attributes 1-57 

conditional assembly expressions 1-5 

constants 1-54 

instructions 1-50 to 1-52 

macro language statements 1-55 

statements 1-53 

variable symbols 1-58, 1-59 
system management facilities (SMF) 5-1 
system restart completion codes 2-29 
System/370 instructions 1-17 to 1-49 



TABSET command 5-19, 5-22 

task control 3-33 

task switch interruption 2-3 

task termination completion codes 2-23 

TCAM 

completion codes 2-21 

section on 7-1, 7-15 to 7-29 
TCBSAV save area 2-4 
TCHNG macro 7-19 
TCOPY macro 7-19 

terminal commands and functions 5-19, 5-21 
TERMINAL macro 7-19, 7-20 
termination 3-32 
TERRSET macro 7-20 
test instructions 1-47, 1-48 
TESTCB macro 4-36, 4-37 
TGOTO macro 7-20 
TGROUP macro 7-5, 7-12 
time intervals 3-28, 3-29 
TIME macro 3-8,3-15 
TLIST macro 7-20 
TPDATE macro 7-20 
TPEDIT macro 7-5,7-20 
TPROCESS macro 7-20 
trace table 2-3 

trailer labels, ANSI 4-25, 4-26 
TRANSLAT macro 7-5 
translate instruction 1-48 
TRLIST macro 7-5,7-12 
TRNSLATE macro 7-5,7-9 
TRSLRCTW macro 7-5,7-9 
TRSLRCT3 macro 7-5,7-9 
TRUNC macro 4-11 
TTABLE macro 7-20 
TTIMER macro 3-8,3-15 
TWAIT macro 7-5,7-9 
TYPETABLE macro 7-20 



UCB sense information 2-6 to 2-15 

unblocked records 4-29 to 4-32 

undefined-length records 4-32 

unit record device statistics table entry 2-1 7 

UNLOAD command 5-11 

UNLOCK macro 7-20 

unpack instruction 1-49 

user label 4-20,4-27 

userid, CRJE 5-23 

USERID command 5-24 

12 OS/VSl Programmer's Reference Digest 



utilities 8-1 

utilities label processing 4-28 

utility programs listed by class 8-2 



variable length records for ASCII tapes 4-32 

VARY command 5-11 

virtual address format 1-60 

virtual storage allocation 3-34 

virtual storage requirements, loader 6-13 

volume organization 

ANSI standard labels 4-21 , 4-22 
IBM standard labels 4-14,4-15 

VSAM macros for data access 4-33 to 4-37 



WAIT completion codes 2-23 
WAIT macro 

BTAM 7-6,7-9 

data management 4-11 

supervisor 3-8, 3-16 
wait state codes 

ICAPRTBL utility 8-8 

system 2-30,2-31 
WAITR macro 3-8,3-16 

workstation operator commands, RES 5-14, 5-15 
write direct instruction 1-49 
WRITE macro 

BTAM 7-5,7-10 

data management 4-11,4-12 

TCAM 7-20 
WRITELOG command 5-11 
WRITER command 5-11, 5-15 
WTL macro 3-8,3-16 
WTO macro 3-9,3-16 
WTO/WTOR completion codes 2-27 
WTOR macro 3-9,3-16 



XCTL 

completion code 2-24 
macro 3-9, 3-16 
XLATE macro 4-12 



zero and add instruction 1-49 



1403/2821 printer codes 1-14 

2305 

capacity 4-13 

linkage editor capacity 6-7 

2305/2835 DASD codes 1-15, 1-16 

2314 

capacity 4-13 

DASD codes 1-15,1-16 

device statistics table entry 2-16 

linkage editor capacity 6-7 

2319 

capacity 4-13 

DASD codes 1-15,1-16 

linkage editor capacity 6-7 



Index 



2400 series device statistics table entry 2-17 

2715 User Table Macros 7-11,7-12 

2820 control unit, device statistics table entry 2-17 

2841 control unit, device statistics table entry 2-17 

3203/IPA printer codes 1-14 

3211/3811 printer codes 1-14 

3330 linkage editor capacity 6-7 

3330 series DASD codes 1-15,1-16 

3330/3333 capacity 4-13 

3340 

capacity 4-13 

linkage editor capacity 6-7 
3340 series DASD codes 1-15, 1-16 
3400 magnetic tape device statistics table entry 2-17 
3410/3411 magnetic tape codes 1-15 
3410 series magnetic tape device statistics table entry 2-18 
3420/3803 magnetic tape codes 1-15 
3420 series magnetic tape device statistics table entry 2-18 
3504, 3505 card reader codes 1-14 
3525 card punch codes 1-14 



14 OS/VS1 Programmer's Reference Digest 



READER'S COMMENT FORM 
OS/VS1 Programmer's 
Reference Digest 
GC24-5091-3 

Your views about this publication may help improve its usefulness; this form 
will be sent to the author's department for appropriate action. Using this 
form to request system assistance or additional publications will delay 
response, however. For more direct handling of such request, please contact 
your IBM representative or the IBM Branch Office serving your locality. 
Your comments will be carefully reviewed by the persons responsible for 
writing and publishing this material. All comments and suggestions become 
the property of IBM. 

Yes No 

• Does the publication meet your needs? I I 1 I 



Did you find the material: 

Organized for convenient use? I I 1 I 

Complete? I I I I 



What is your occupation? - 



How do you use this publication: 

As an instructor in a class? 1 I 

As a student in a class? I 1 

As a reference manual? I I 



Your comments: 



If you would like a reply, please supply your name and address. 
IBM Branch Office serving you_ 



Thank you for your ccipsri'.icn. No postage stamp necessary if mailed in 
the U.S.A. (Elsewhere, an IBM office or representative will be happy to 
forward your comments.) 



From: 



First Class 
Permit 170 
Endicott 
New York 



Business Reply Mail 

No postage stamp necessary if mailed in the U.S.A. 




Postage will be paid by: 



International Business Machines Corporation 

Department G60 

P. O. Box 6 

Endicott, New York 13760 



GC24-5091-3 



O 



International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 

(U.S.A. only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International)